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Preface 



The MAP language and its use in writing 7090/7094 
programs are described in this pubHcation. This sym- 
bolic language encompasses all 7090/7094 machine 
operations, extended machine operations, and special 
operations. In addition, map provides more than sixty 
pseudo-operations, including the powerful macro- 
facility, all of which are described in this publication. 

MAP language programs are processed by the 7090/ 
7094 assembly program, ibmap, which is a component 
of the 7090/7094 ibjob Processor and which operates 
under the ibjob Monitor. The facilities of iocs, Fortran, 
and COBOL are accessible to the map user. 

To assist the user in making the most effective use of 
this flexible programming tool, basic information about 
the map language is provided in Part I of this publica- 
tion. Its main features and capabilities are outlined, and 
the constituents of map symbolic instructions are ex- 
plained. 

The pseudo-operations provided by map have been 
divided into classes according to function. Most of the 
pseudo-operations are described in Part II, where their 
formats are shown and their use in programs is ex- 
plained and demonstrated. 

The macro-facility is described separately in Part III. 



Five appendixes following Part III provide supple- 
mentary information related to the map language. 

It has been assumed that the reader is familiar With 
the contents of one of the following publications : 
IBM 7090 Principles of Operation, Form A22-6528 
IBM 7094 Principles of Operation, Form A22-6703 

The following related publications may also be use- 
ful, depending on individual interests and require- 
ments: 

IBM 7090/7094 IBSYS Operating System: Version 

13, System Monitor (IBSYS), Form C28-6248 
IBM 7090/7094 IBSYS Operating System: Version 

13, IBIOB Processor, Form C28-6389 
IBM 7090/7094 IBSYS Operating System: Version 
13, Input/Output Control System, Form C28-6345 
IBM 7090/7094 IBSYS Operating System: Version 

13, FORTRAN IV Language, Form C28-6390 
IBM 7090/7094 IBSYS Operating System: Version 

13, COBOL Language, Form C28-6391 
Machine requirements for map language programs 
are given in the publication IBM 7090/7094 IBSYS 
Operating System: Version 13, IBIOB Processor, Form 
C28-6389. 



This publication. Form C28-6392-0, updates the material in 
Forms C28-6311-3 and N28-0128 for users of Version 13 of the 
IBSYS Operating System. 

The principal changes in this edition are the addition of the 
LOG pseudo-operation to the Location-Counter group and the 
addition of a new group, Literal-Positioning Pseudo-Operations, 
which coiTiprises the LORG pseudo-operation and a new 
LITORG pseudo-operation. Several miscellaneous changes have 
also been made. All changes are identified by a vertical line to 
the left of the changed material. 



Copies of this and other ibm publications can be obtained through ibm Branch QlBces. 

Address comments concerning the contents of this publication to : 

IBM Corporation, Programming Systems Publications, Dept. D91, 1271 Avenue of the Americas, New York, N. Y. 10020 
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Part I. Symbolic Programming Using MAP 



Programmers can communicate instructions to com- 
puters at three general language levels. The language 
of the computer itself is the most basic. At the highest 
level are scientific and commercial programming lan- 
guages, such as FORTRAN and cobol, respectively. 
Assembly-program languages like the map (Macro 
Assembly Program) language are at the intermediate 
level. 

Because the computer executes instructions at the 
machine-language level, a source program written at 
either of the other two levels must be reduced to a 
machine-language object program before it can be 
executed. Machine-language programming is theo- 
retically the most efficient, since no translation from 
source program to object program is required. For the 
programmer, however, programming in machine lan- 
guage is tedious and time consuming, and program- 
ming errors are more likely. 

A source program written in the Fortran language 
closely resembles the mathematical notation used to 
state a problem to be solved by traditional methods. 
The COBOL language is based on English statements 
much like those that would be used to explain a pro- 
cedure. These languages are relatively easy to learn 
and to use because of their similarity to the ordinary 
languages of business and science. 

Source programs written in these languages are 
translated into machine-language programs within the 
computer by a compiler program. By using a compiler, 
the computer can produce an efficient m.achine- 
language program from a Fortran or cobol source 
program faster and more accurately than a programmer 
can. Such compiler languages thus oflFer marked advan- 
tages over machine-language programming. However, 
compilejr languages are somewhat restrictive. Some 
programming features that are available when using 
machine language cannot be included in any present- 
day compiler. 

An assembly-program language is similar in structure 
to machine language. However, mnemonic symbols are 
substituted for each binary instruction code, and sym- 
bols provided by the programmer are substituted for 
the other fields of an instruction. An assembly-program 
language can also provide additional advantages be- 
yond machine-language programming. For example, 
pseudo-operations can be provided, which often permit 
the coding of one instruction instead of many instruc- 
tions. Thus, an assembly program provides the pro- 
grammer with all the flexibility and versatility of 



machine language but with greatly reduced program- 
ming eflFort. In addition, error checking can be included 
to facilitate source program debugging. 



7090/7094 MAP Language Features 

Operations 

The 7090/7094 m-ap (Macro Assembly Program) lan- 
guage can be used for all of the 7090/7094 machine 
operations, the extended machine operations, and the 
special machine operations. (All such operations rec- 
ognized by MAP are listed in Appendix A with supple- 
mentary information about them. ) In addition, the map 
language provides an extensive set of pseudo-opera- 
tions that supplement machine instructions. 

A pseudo-operation is any operation included in the 
MAP language that is not an actual machine operation, 
extended machine operation, or special machine opera- 
tion. Pseudo-operations are used by the programmer in 
much the same way as machine operations, map pro- 
vides more than sixty such pseudo-operations to meet 
a variety of programming needs. These pseudo-opera- 
tions, which are described in detail in Parts II and ID, 
have been divided into classes according to function. 

Location-Counter Pseudo-Operations enable the pro- 
grammer to establish symbolic location counters and 
control their operation. 

Storage-Allocation Pseudo-Operations reserve areas 
of core storage. 

Data-Generating Pseudo-Operations introduce data 
into a program in any of a variety of formats. They are 
also used in combination to generate tables of data. 

Symbol-Defining Pseudo-Operations are used to as- 
sign specific values to symbols. 

Boolean Pseudo-Operations define symbols as Boolean 
quantities. 

Conditional- Assembly Pseudo-Operations base as- 
sembly of an instruction on programmer established 
criteria. 

Symbol-Qualifying Pseudo-Operations qualify sym- 
bols within sections of a program. 

Control-Section Pseudo-Operations delimit sections 
of a program, facilitating cross-referencing among pro- 
grams and among program segments. 

File-Description Pseudo-Operations define the re- 
quirements of input/output files used by the program. 

Operation-Defining Pseudo -Operations define or re- 
define symbols as operation codes. 
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Miscellaneous Pseudo-Operations indicate the end of 
a program, extend the variable field of an operation, 
and permit remarks to be entered into the assembly list- 
ing. 

Absolute-Assembly Pseudo-Operations specify the 
punched output format of an absolute assembly. 

List-Control Pseudo-Operations specify the contents 
and format of an assembly listing. 

Special Systems Pseudo-Operations generate subrou- 
tine calling sequences. They may also be used to save 
and restore the index registers and indicators. 

Macro -Defining Pseudo-Operations are used to de- 
fine programmer macro-operations. They are used in 
conjunction with the macro-related pseudo-operations, 
which extend the facilities of macro-operations. 

Mcicro-Ope rations 

The programmer macro-operation facility is a very 
flexible and powerful programming tool. Many pro- 
gramming applications involve a repetition of a pattern 
of instructions, often with parts of the instructions 
varied at each iteration. Using the macro-defining 
pseudo-operations, a programmer can define the 
pattern as a macro-operation. 

In defining the pattern, the programmer gives it a 
name that becomes the operation code used to gener- 
ate the pattern of instructions. Thus, the coding of a 
single instruction can cause the pattern of instructions 
to be repeated as often as desired. Moreover, parts of 
the instruction can be varied each time the sequence 
is i-epeated. The contents of any field of any instruction 
within the pattern may be varied, and even entire in- 
structions can be inserted in the sequence. The macro- 
operation facility is described in Part III. 

Location Counters 

During assembly, a location counter registers the next 
location to be assigned to an instruction. For most ma- 
chine instructions processed by the assembly program, 
the contents of the location counter in effect at that 
time (the "current" location counter) is increased by 
1. Some pseudo-operations may result in no increase, 
an increase of 1, or an increase of more than 1. 

iviAP enables a programmer to create and control as 
many symbolic location counters as he needs by using 
the location-counter pseudo-operations. Control can be 
transferred back and forth among them as often as 
desired. 

This feature permits instructions coded in one se- 
quence to be loaded in another, the establishment of 
constant tables, etc. 

Absolute and Relocatable Assemblies 

The control routines of the operating system occupy 
lower core storage. Therefore, a program may not be 



loaded into this area but must be loaded into the first 
unused machine location. However, the programmer 
need not know the address of this location, since the 
loader (ibldr) can automatically relocate each pro- 
gram segment to be loaded. 

The first address of a program segment to be exe- 
cuted is called the load address, and each succeeding 
instruction is loaded relative to that address. Thus, 
the address of an instruction at load time is the address 
assigned to it during assembly plus the load address 
of the program segment in which the instruction ap- 
pears. 

In a relocatable assembly, the assembly program pro- 
duces an object deck that is automatically relocated at 
execution time by ibldr. However, it may sometimes 
be desirable to load a program beginning at a certain 
fixed location in core storage. A program loaded in this 
way is said to have an absolute origin. The programmer 
specifies a certain location as the load address for that 
deck. ( An absolute origin may also be specified within 
a relocatable assembly. See the section "Relocation 
Properties of Symbols.") 

In absolute assemblies, output is in the standard 22- 
word-per-card format, which is specified on the sibmap 
control card and by the abs pseudo-operation. Output 
in this format cannot be handled by ibldr. Whether the 
assembly is absolute or relocatable is specified by the 
programmer on the sibmap card , ( see the publication 
IBM 7090/7094 IBSYS Operating System: IBJOB Proc- 
essor, Form C28-6389. ) 

Error Checking 

Source programs written in the map language are 
checked for a variety of errors, including format errors, 
table overflow errors, input/output errors, improper 
references, and incorrectly coded operations. In addi- 
tion, the severity of the error is indicated. 

In a normal assembly, messages are printed just after 
the assembly listing. All messages for a given card are 
printed together, and the card groups are printed in 
ascending sequence. Correlation with the listing is ac- 
complished by printing the line number, which is as- 
signed by the assembly program, in the left margin of 
the listing for each card that requires a message. 

A list of MAP error messages and an explanation of 
the severity code used are included in the publication 
IBM 7090/7094 IBSYS Operating System: IBIOB Proc- 
essor, Form C28-6389. 



Forming Symbolic Instructions 

Instruction Fields 

In the MAP language, each symbolic instruction is 
punched on a separate standard ibm card. A single 



instruction may have as many as five parts, occupying 
five fields on the card. 

THE name; field 

An instruction may be given a symbohc name by the 
programmer, so that references may be made in other 
instructions to the named instruction. ( Other methods 
are also available for referring from one instruction to 
another. For example, see the section "Relative Ad- 
dressing.") 

The use of a name is generally optional. However, 
some pseudo-operations do require a symbc^l in the 
name field. Name-field and other requirement^ of each 
of the pseudo-operations are explained in Parts II and 
III. Also, the specifications for symbols used in the 
name field are given in the section "Symbols." 

The name given to a symbolic instruction is from 1 
to 6 characters long, and it occupies columns 1 through 
6 on the card. 

THE OPERATION FIELD 

The machine operation code, pseudo-operation code, 
programmer macro-operation code, or an operation 
code previously defined by one of the operation- 
defining pseudo-operations appears in the operation 
field. 

The operation field is punched beginning in column 
8. Column 7 separates the name field from the opera- 
tional field. Column 7, which is usually left blank, is 
ignored by the assembly program. 

The character asterisk ( * ) may be used immediately 
to the right of some operation codes to indicate 
indirect addressing. Those machine instructions that 
are indirectly addressable are indicated in Appendix 
A. If indirect addressing is specified for an instruction 
in which it is not permitted, the asterisk ( * ) is ignored 
and a low-severity error message is issued. 

The operation field is usually restricted to a maxi- 
mum of six characters. However, an operation code of 
six characters defined by one of the operation-defining 
pseudo-operations may be followed by an asterisk ( * ) 
to indicate indirect addressing. 

THE VARIABLE FIELD 

The variable field of a symbolic instruction may con- 
tain subfields, separated by commas. 

In machine instructions, these subfields contain the 
address, tag, and/or decrement (or count) parts of 
instruction, depending on the requirements of the 
particular instruction. These parts of the variable field 
are supplied in the order: address, tag, decrement. 

The subfields that are required, optional, or not per- 
mitted in the variable fields of air 7090/7094 machine 
instructions, extended machine operations, and special 
operations are indicated in Appendix A. 



In pseudo-operations, the subfields of the variable 
field may contain symbols, symbolic expressions, and 
literals. The contents of the variable field specified for 
each of the map pseudo -operations is given in Parts 11 
and III. 

A null subfield is indicated as being present but as 
having no value. If a null subfield is at the beginning 
of the variable field, it is indicated by a single comma. 
If it is between two other subfields, it is expressed by 
two consecutive commas. A null subfield at the end of 
the variable field is represented by a single comma 
followed by a blank. 

If a subfield that is not used in the variable field ( an 
irrelevant subfield ) is to be followed by a subfield that 
is required ( a relevant subfield ) , the irrelevant subfield 
must be indicated. Irrelevant subfields at the end of 
the variable field may be indicated as null or may be 
omitted entirely. For example, the following pairs of 
instructions are equivalent: 



TXH 
TXH 


0,0,1 
»1 


lORP 
lORP 


ALPHA,0,1 
ALPHA,, 1 


CLA 
CLA 


ALPHA,0 
ALPHA 


TXH 
TXH 


ALPHA,0,0 
ALPHA,, 


PXA 
PXA 


0,0 



In the last two pairs, the commas may not be omit- 
ted, since the assembly program checks for a minimum 
number of subfields. The txh instruction requires three 
subfields, while the pxa instruction requires two. These 
subfields are not irrelevant and must be included. 

The variable field is separated from the operation 
field by at least one blank column. The variable field 
may begin in column 12 but may never begin after 
column 16. The variable field cannot extend beyond 
column 72. An instruction having a variable field ex- 
tending into column 72 may not have a comments field. 
However, the variable field of most instructions may 
be extended over more than one card, each having its 
own comments field, by using the etc pseudo-opera- 
tion. 

THE COMMENTS FIELD 

The comments field is included for the convenience of 
the programmer and does not affect execution of the 
program. This field is generally used for explanatory 
remarks. (See also the section "The Asterisk (*) Re- 
marks Cards.") 

A blank precedes the comments field to separate it 
from the variable field. This field extends througli 
column 72 on the card. If there is a blank variabk; 
field, the comments field may begin as soon as column 
17. An example of the use of the comments field is 
shown in Figure 1. 
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Figure 1. Example of MAP Coding Shows Use of Comments Field 



THE SEQUENCE FIELD 

Symbolic instructions may be numbered for identifica- 
tion in the sequence field, which includes columns 73 
through 80 on the card. 

THE ASTERISK ( * ) REMARKS CARD 

The remarks card is a special source card with an as- 
terisk ( * ) in column 1 and any desired information in 
the rest of the card. 

Any card with an asterisk in column 1 is treated by 
th(; assembly program as a remarks card, and its con- 
tents are printed out in the assembly listing. It has no 
other effect on the assembly. 

Remarks cards may be grouped and may appear 
anywhere in a program except in macro-operations or 
between etc cards. They are frequently used at the 
beginning of a program to state the problem to be 
solved, to describe the technique used, etc. (map also 
makes a remarks card available by using the pseudo- 
operation REM, which is described in the section "The 
REM Pseudo-Operation.") 

Examples of remarks cards are shown in Figure 1, 
as well as methods of coding a variable field. 

Symbols 

The symbolic names used in the name and variable 
fields of symbolic instructions consist of one to six non- 
blank BCD characters (see Appendix E). At least one 
nonnumeric character must be included, but none of 
the following ten characters may be used: 
+ 



(plus sign) = 

— (minus sign) , 

* ( asterisk ) ' 

/ (slash) ( 

$ (dollar sign) ) 

Parentheses in a symbol cause a low-severity warn- 
ing message to be printed, but assembly is not aflFected. 
However, the ( )ok option specified on the sibmap 



( equal sign ) 

(comma) 

( apostrophe ) 

( left parenthesis ) 

( right parenthesis ) 



control card (see the publication IBM 7090/7094 
IBSYS Operating System: IB JOB Processor, Form: 
C28-6389 ) indicates that parentheses in symbols are 
desired, and no message will be printed. 
Examples of valid symbols are: 

A 3.2XY 

37B2 DECLOC 

DELTA 

Conversely, the following are not valid symbols for 
the reasons indicated: 

A -I- B ( invalid character ) 

3921 ( no nonnumeric characters ) 

A2B4C6D ( more than six characters ) 

Defining Symbols 

When a symbol has been assigned a value, it is said 
to be defined. The assigned value can be the address 
of a location within core storage, an arbitrary quantity 
specified by the programmer, or a dependent value 
assigned by the assembly program. Values are assigned 
to symbols during and after the first of the two passes 
made by the assembly program over the source pro- 
gram. Further information about the assembly pro- 
gram is provided in the publication IBM 7090/7094 
IBSYS Operating System: IBJOB Processor. Form 
C28-6389. 

Ordinary Symbols 

Several types of symbols are used in the variable fields 
of machine instructions and in most of the pseiiido- 
operations. 

1. Location symbols are so called because of their 
appearance in the name field of an instruction. During 
the first pass of the assembly program, location sym- 
bols in the variable field of an instruction are immedi- 
ately assigned a value called an S-value. The S-value 
is 1 if the symbol has previously appeared in the name 
field of an instruction and if it has not. After the first 
pass has been completed, these symbols are assigned 



the value of the address of the instruction in which 
they appeared as a name-field symbol. 

Absolute symbols are location symbols having fixed 
values that are independent of any relocation of the 
program segment. 

2. Virtual symbols are used in the variable field of 
an instruction and never appear in any name field. 
Virtual symbols, which have special functions in map, 
are defined at load time. The S-value is 0. ( For further 
information, see the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6389. ) 
Virtual symbols are permitted only in a relocatable 
assembty. In an absolute assembly, virtual symbols are 
flagged as undefined. 

3. System symbols from the ibsys, ioex and ibjob 
communication regions are predefined by the assem- 
bler if a System Symbol Option ( monsym or jobsym ) 
appears on the sibmap control card. If symbols thus 
defined are used in the variable field of an instruction 
in the source program, they will be treated as absolute 
symbols appearing in the qualification section "S.S." 
The S-value is 1. (For further information concerning 
the use of the System Symbol options, and the symbols 
involved, see the publication, IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6389. ) 

Immediate Symbols 

Immediate symbols are created by using them in the 
name field of the set pseudo-operation. Immediate 
symbols are assigned a value ( S-value ) during the first 
pass of the assembly program. Immediate symbols may 
also be redefined throughout a program by using ad- 
ditional SET pseudo-operations. (See the section "The 
SET Pseudo-Operation.") The final value of an imme- 
diate symbol is used in evaluating variable fields of 
pseudo-operations afi^ecting location counters. 

Relocation Properties of Symbols 

An absolute origin may be specified in a relocatable as- 
sembly, which should not be confused with an absolute 
assembly. If an absolute origin is given in a relocatable 
assembly, any symbols whose definitions depend on 
that origin are absolute. However, instructions under 
the absolute origin may refer to symbols elsewhere in 
the program. The assembly can be returned to the re- 
locatable mode by subsequently specifying a relocat- 
able origin. 

Under the following conditions, symbols are abso- 
lute even if they appear within a relocatable assembly: 

1. Symbols whose values depend on an absolute 
origin (as a result of using the org or begin pseudo- 
operations ) . 

2. Symbols defined by the bool, rbool, and lbool 
pseudo-operations. 



3. Symbols defined by the equ or syn pseudo-opera- 
tions and whose values reduce to a constant, 

4. Symbols defined by a max or min pseudo-opera- 
tion that yield a constant. 

5. Symbols used in the variable field of type D in- 
structions. 

I 6. Symbols defined by the set pseudo-operation. 

Literals 

Literals provide a simple means for introducing data 
words and constants into a program. For example, if a 
programmer wishes to add the number 1 to the con- 
tents of the accumulator, he must have the number 1 at 
some location in storage. 

In contrast to other types of subfields, the contents of 
a literal subfield is itself the data to be operated on. 
The appearance of a literal directs the assembly pro- 
gram to prepare a constant equal in value to the con- 
tent of the literal subfield. The assembly program 
replaces the subfield of the variable field of the in- 
struction containing the literal with the address of the 
constant thus generated. 

All the literals used in a program are placed in the; 
Literal Pool. Unless the programmer specifies another 
location (see "Literal-Positioning Pseudo-Operations"), 
the Literal Pool begins one location beyond the final 
value of the location counter in use at the end of 
the program. 

There are three types of literals — decimal, octal, and 
alphameric. 

DECIMAL LITERALS 

A decimal literal consists of the character = followed 
by a decimal data item. Three types of decimal data 
items are recognized by map: 

Decimal Integers. A decimal integer is one or more 
of the digits through 9, and it may be preceded by a 
plus or minus sign. Maximum size of the decimal in- 
teger is 2^^ — 1. 

Floating-Point Numbers. A floating-point number 
has two components. 

1. The principal part is a signed or unsigned decimal 
number, which may be written with or without a deci- 
mal point. The decimal point may appear at the be- 
ginning, at the end, or within the decimal number. If 
an exponent part is present, the decimal point may be 
omitted, in which case it is assumed to be at the right 
end of the decimal number. The principal part cannot 
exceed twenty digits. If it does, the number will be 
truncated and only the first twenty digits will be used. 

2. The exponent part consists of the letters e or ek 
followed by a signed or unsigned decimal integer. 
(The letters ee indicate a double-precision floating- 
point number. ) The exponent part may be omitted. If 
the exponent part is used, it must follow the principal 
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part. The exponent part cannot exceed two digits. If it 
does, it vi/ill be truncated and only the first two digits 
will be used. 

A floating-point number is converted to a normalized 
floating-point binary word. The exponent part, if pres- 
ent, specifies a power of ten, by which the principal 
part is multiplied during conversion. For example, all 
of the following floating-point numbers are equivalent 
and are converted to the same floating-point binary 
number. 

3.14159 

31.4159E-1 

314159.E-5 

314159E-5 

.314159E1 

The octal representation of this number is 
202622077174 

Similarly, the number .314159eei is converted to a 
double-precision floating-point number. Its octal repre- 
sentation is 

202622077174 
147015606335 

Fixed-Point Numbers. A fixed-point number has 
three components. 

1. The principal part is a signed or unsigned decimal 
number, which may be written with or without a deci- 
mal point. The decimal point may appear at the begin- 
ning, at the end, or within the decimal number. If the 
decimal point is omitted, it is assumed to be at the 
right end of the decimal number. The principal part 
cannot exceed twenty digits. If it does, the number will 
be truncated and only the first twenty digits will be 
used. 

2. The exponent part consists of the letters e or ee 
followed by a signed or unsigned decimal integer. 
(The letters ee indicate a double-precision fixed-point 
number.) The exponent part may be omitted. If the 
exponent part is used, it must follow the principal part. 
The exponent part cannot exceed two digits. If it does, 
it will be truncated and only the first two digits will 
be used. 

3. The binary-place part consists of the letters b or 
BB followed by a signed or unsigned decimal integer. 
(The letters be indicate a double-precision fixed-point 
number. ) The binary-place part must be present in a 
fixed-point number and must come after the principal 
part. If the number has an exponent part, the binary- 
place part may either precede or follow the exponent 
part. The binary-place part may not exceed two digits. 
If it does, the number will be truncated and only the 
first two digits will be used. 

A fixed-point number is converted to a fixed-point 
binary number that contains an understood binary 
point. The binary-place part specifies the location of 
this understood binary point within the word. The 



number that follows the letters b or bb specifies the 
number of binary places in the word at the left of the 
binary point. The sign bit is not counted. Thus, a 
binary-place part of zero specifies a 35-bit binary frac- 
tion. B2 specifies two integral places and 33 fractional 
I places, B35 specifies a binary integer, b-2 specifies a 
binary point located two places to the left of the 
leftmost bit of the word; that is, the word would con- 
tain the low-order 35 bits of a 37-bit binary fraction. As 
with floating-point numbers, the exponent part, if pres- 
ent, specifies a power of ten, by which the principal 
part will be multiplied during conversion. 

For example, the following fixed-point numbers all 
specify the same bit configuration, but not all of them 
specify the same location for the understood binary 
point: 

22.5B5 
11.25B4 
1125E-2B4 
9B7E1 

All of the above fixed-point numbers are converted 
to the binary configuration having the octal repre- 
sentation 

264000000000 

The following double-precision fixed-point numbers 

10BB35 
1B35EE1 
1BB35E1 
1BB35EE1 

are converted to the binary configuration having the 
octal representation 

000000000012 
000000000000 

Double-precision literals are stored in consecutive 
locations. The first or high-order part is automatically 
stored in an even location relative to the beginning of 
the Literal Pool. If these literals are to be used as oper- 
ands in double-precision operations (7094), an even 
pseudo-operation must be inserted immediately before 
the LORG pseudo-operation if there is one; otherwise it 
must be inserted before the end pseudo-operation. 

OCTAL LITERALS 

An octal literal consists of the two characters =0 
followed by an octal integer. 

An octal integer is a string of not more than twelve 
of the digits through 7, and it may be preceded by a 
plus or minus sign. 

Examples of octal literals are: 



=0123 
= + 123 
= 0-123 



000000000123 
000000000123 
400000000123 



ALPHAMERIC LITERALS 

An alphameric literal consists of the two characters 
= H followed by exactly six alphameric characters. 
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The six characters following the H are treated as data 
even if one or more of them is a comma or a blank. 
Examples of alphameric literals are: 

=H12ABCD 

= HTADbbb, where b represents a blank 

Writing Expressions 

The programmer writes expressions to represent the 
subfields of the variable field of symboHc instructions. 
Expressions are also used in the variable fields of many 
of the pseudo-operations in accordance with the rules 
set forth for each specific case. 

Expressions are comprised of elements, terms, and 
operators. 

ELEMENTS 

An element is the smallest component of an expression 
and is either a single symbol or a single integer less 
than 2^^. The asterisk ( *) may be used as an element 
representing the location of the instruction in which it 
appears. 

Examples of valid elements are: 

A 

427 
ALPHA 

TERMS 

A term is a group of one or more elements and the 
operators * (indicating multiphcation ) and / (indi- 
cating division). 

A term consists of one or more elements, with each 
element separated by an operator. A term must begin 
and end with an element. Two operators or two ele- 
ments in succession are never permissible. 

Examples of valid terms are: 



A 


A*B 


427 


C/1409 


ALPHA 


BETA*GAMMA/DELTA 



There is no ambiguity between using the asterisk 
as an element and its use to denote multiplication, since 
position always makes clear its intended function. For 
example, a field coded 

would be interpreted as "the location of this instruction 
multiplied by B." Since a term must begin with an 
element, the first asterisk must be an element. The 
second asterisk must be an operator, which is required 
between two elements. 

EXPRESSIONS 

An expression is a group composed of one or more 
terms and the operators + (signifying addition) and 
— ( signifying subtraction ) . 

An expression consists of one or more terms, with 
each term separated by a plus or minus sign. Two op- 
erators or two terms in succession are never permiss- 



ible. However, an expression may begin with a plus 

or minus sign. Examples of valid expressions are: 

A 

ALPHA 

ALPHA*BETA 

-A/B 

A*B-C/D-I-E*2303 

*-A-l-B*C 

The asterisk in the last example is used first as an 

element and then as an operator. 

Evaluating Expressions 

In evaluating expressions, elements are evaluated first, 
then individual terms, and finally the complete expres- 
sion. The following procedure is used in evaluating 
expressions: 

1. Each element is replaced with its numeric value. 

2. Each term is evaluated by performing the indi 
cated multiplications and divisions from left to right. 
In division, the integral part of the quotient is retained 
and any remainder is discarded immediately. For ex 
ample, the value of the term 5/2*2 is 4. 

In evaluating a term, division by zero is the same as 
division by one and results in the original dividend. 
Division by zero is not regarded as an error. 

3. Terms are combined from left to right in the order 
in which they occur, with all intermediate results re 
tained as 35-bit signed numbers. 

4. Finally, if the result is negative, it is comple- 
mented; in either case, the rightmost 20 bits are re 
tained if the expression is a subfield of a vfd pseudo- 
operation. Otherwise, only the rightmost 15 bits are 
retained. 

Grouping of terms by parentheses or any other 
means is not permitted. However, a product such as 
A(B-C) can be written simply a*b-a*c. 

The expression ** may be used to designate a field 
the value of which is to be computed and inserted by 
the program. It is an absolute expression having a value 
of zero. 

Rules for Forming Expressions 

The use of expressions is sometimes affected by whether 
elements within the expression are relocatable, abso 
lute, or a combination of both. 

In a relocatable assembly, an expression that con 
tains more than one symbol is generally complex. An 
expression that includes a control-section name is also 
complex. In addition, any expression that contains a 
complex element is itself complex. 

In an absolute assembly, all expressions are absolute. 

Relocatable and complex expressions are usually 
evaluated at load time, when absolute values have 
been assigned to symbols as part of the loading process. 
However, in pseudo-operations that affect location 
counters (such as bes, bss, and begin) or that define 
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symbols (such as max and min), the variable field 
must be evaluated before load time. For further in- 
formation, see the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6389. 
The rules that must be followed in using expressions 
are provided in the discussions of the pseudo- 
operations. 

Boolean Expressions 

A Boolean expression is evaluated as an 18-bit Boolean 
quantit)% unlike the 15-bit integer that normally results 
from the evaluation of an expression. Elements within 
a Boolean expression must be constant. All integers are 
specified as octal integers. An expression is Boolean if: 

1. It appears in the variable field of a Boolean 
pseudo-operation (bool, rbool, lbool; see the section 
"Boolean Pseudo-Operations" ) ; 

2. It appears as an octal subfield of a vfd pseudo- 
operation (see the section "The vfd Pseudo-Opera- 
tion" ) ; or 

3. It forms the variable field of a Type D or extended 
Type D machine instruction ( see Appendix A ) . 

Relocatable symbols in a Boolean expression are 
evaluated as 15-bit integers and virtual symbols are 
evaluated as zero. In either case, an error message is 
issued. 

In a Boolean expression, the four operators ( + , — , 
*, /) have Boolean rather than arithmetic meanings, 
as shown in the table. 



OPERATOR 


MEANING 




DEFINITION 


+ 


"inclusive or" 


( also, 


+ 0=0 




"union" ) 




+ 1 = 1 
1+0=1 

1 + 1 = 1 


- 


"exclusive or" 


( also, 


0-0=0 




"symmetric differ- 


0-1 = 1 




ence" ) 




1-0=1 
1-1=0 


* 


"and" ( also, 


"inter- 


0*0 = 




section" ) 




0*1 = 
1*0=0 
1*1 = 1 


/ 


"complement" 


(also, 


/0=1 




"not" or "ones' 


com- 


/1 = 



plement" ) 

The four Boolean operations are defined in the table 
for 1-bit quantities. The operation is extended to 18-bit 
quantities by handling each bit position independently. 

The following conventions also apply in using Bool- 
ean expressions: 

The / is a unary or one-term operator. The expres- 
sion A/B means /b, and the a is ignored. However, the 
presence of the a is not regarded as an error by the 
assembly prog;ram. The definitions of / in this case are: 

0/0=1 
0/1=0 
1/0 = 1 
1/1=0 



If the other operators ( + , — , * ) are used as unary 
operators, the definitions are as follows: 

+A=A+=A 
-A=0-A,A-=A-0 
*A=error,-A* = A*0 = 

For the special case of the slash, the definition is: 

A/=A/0 = 1 

In expressions where both terms are missing, defini- 
tions are as follows: 

+ =0 + 0=000000 
-=0-0 = 000000 
* = Location counter 

/ = 0/0 = 777777 

In evaluating a Boolean expression, all integers are 
treated as 18-bit quantities. The operation / is per- 
formed first, followed by *, then by 4- and — . 

The operators + , — , and * may immediately pre- 
cede the slash in a Boolean expression. For example, 

A-/B 
is a valid Boolean expression. However, in no other 
case are two operators or two elements in succession 
permitted. 

Using Symbols in Expressions 

In MAP, ordinary symbols are not assigned values until 
a pass over the entire program has been completed. 
Therefore, there are no restrictions in the order of 
symbol definition. For example. 



A 
10000 



ORG 
A EQU 

is a valid sequence in ibmap. 

Symbols in the variable field of pseudo-operations 
that affect location counters must be definable at as- 
sembly time. In the sequence 



BEGIN 


,A 


BSS 


B 


BES 


C 



A, B, and C may not be virtual symbols. (The org 
pseudo-operation is not subject to this restriction. ) The 
values of symbols B and C are always treated as 
constant. 

In general, any valid expression may appear in the 
variable field of machine instructions. In a relocatable 
assembly, final evaluation of complex arithmetic; ex- 
pressions containing virtual symbols actually takes 
place at load time, when all symbols have been defined. 

Relative Addressing 

After an instruction has been named by the presence 
of a symbol in the name field, references to that in- 
struction can be made in other instructions by using 
the symbol. Instructions preceding or following the 
named instruction can also be referenced by indicating 
their position relative to the named instruction. This 
procedure is called relative addressing. A relative 
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address is, effectively, a type of expression. For exam- 
ple, in the sequence 



ALPHA 



STGAM 



TRA 
CLA 

SUB 
STO 
TPL 



BETA 

GAMMA 

DELTA 

GAMMA 

LOCI 



control may be transferred to the instruction cla 

GAMMA by either of the following instructions: 

TRA ALPHA +1 

TRA STGAM -2 

It is also possible to use the asterisk ( * ) as an ele- 
ment in a relative address. For example, in the 
sequence 

AXT 10,1 

LOOP CLA A,l 

SUB B,l 

SUB C,l 

STO SUM,1 

TIX LOOP,l,l 

the last instruction indicates a conditional transfer to 

location loop. This could also be written 

TIX * -4,1,1 



The address * — 4 is interpreted as "the location of 
this instruction minus 4." 

Relative addressing must be used carefully in com- 
bination with pseudo-operations, since some pseudo- 
operations may generate more than one word or no 
words in the object program. For example, the in- 
struction 



ALPHA 



OCT 



2732,427,12716 

generates three words of octal data, with alpha as- 
signed to the address of the first word generated. Thus 
the address alpha +2 refers to the third word gener- 
ated (12716). 

Reference can also be made to a word in a block of 
storage reserved by a bss or bes pseudo-operation by 
using relative addressing. For example, the instruction 

BETA BSS 50 

reserves a block of 50 words, where beta is assigned 
to the first word of the block. The address beta+ i refers 
to the second word, and BETA + n refers to the (n + l)st 
word. 
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Part II. MAP Pseudo-Operations 



MAP provides the programmer with more than sixty 
pseudo-operations that can perform a variety of pro- 
gramming functions with greatly reduced program- 
ming effort. They have been grouped according to 
function, and the structure and purpose of most of the 
MAP pseudo-operations are described in this part of the 
publication. The macro-operation facility is covered 
separately in Part III. 



Location-Counter Pseudo-Operations 

Location counters enable instructions that are written 
in one sequence to be loaded in a different sequence. 
MAP enables a programmer to estabHsh an indefinite 
number of location counters, which can be repre- 
sented by symbols of his choice. The symbol used to 
represent a location counter may duplicate any other 
symbol in the program except another location-counter 
symbol. 

The blank location counter, so called because it has 
no associated symbol, is the basic location counter. If 
the USE pseudo-operation is not used, instructions are 
assembled under the blank location counter. In addi- 
tion, a location counter represented by two slashes 
( // ) is reserved for use with blank common. 

The USE Pseudo-Operation 

The USE pseudo-operation places succeeding instruc- 
tions under control of the location counter represented 
by the symbol in the variable field. The format of the 
USE pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


USE 


Either: 

1. A single symbol, or 

2. Blanks, or 

3. //, or 

4. The word PREVIOUS 



The location counter in control at the time of the 
USE pseudo-operation is suspended at its current value. 
It is temporarily preserved as the "previous" counter. 
It continues from this value if it is reactivated by 
another use. If use with the word previous in the vari- 
able field is coded, the previous location counter is 
reactivated. For example, the effect of the sequence 



is identical to that of 

USE A 

USE B 

USE A 

This option provides a means of returning to a 
location counter even if the counter symbol is not 
known. 

A USE pseudo-operation with a blank variable field 
must precede the first instruction of the deck if the 
blank counter is set to a value other than zero by the 
operation 

BEGIN , expression 

The sequence of location counters is: the blank 
counter first, the other symboHc counters in the order 
of their first appearance in a use or begin pseudo- 
operation, and finally the // counter. 

The BEGIN Pseudo-Operation 

The BEGIN pseudo-operation specifies a location counter 
and establishes its initial value. The format of the 
BEGIN pseudo-operation is: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


Blanks 


BEGIN 


Two subfields, separated by 
a comma: 

1. A location counter symbol, 

2. Any expression 



USE 


A 


USE 


B 


USE 


PREVIOUS 



The expression in the variable field may contain any 
symbol or constant. Relocatable symbols are given 
their assembly value, and this value becomes absolute. 
Control-section symbols are given a value of zero. 

The value of the second subfield of the variable field 
is used as the initial value for the location counter 
represented by the symbol in the first subfield. For 
example, the instruction 

BEGIN ALPHA,BETA 

would cause the instructions following 

USE ALPHA 

to be assembled beginning at location beta. 

If no BEGIN is given for the blank location counter, its 
initial value is defined as ( absolute in an absolute 
assembly and relative in a relocatable assembly). If 
no BEGIN is given for the nth location counter ( taken in 
location counter order), its initial value is given as the 
last value by the (n — J)st location counter. If more 
than one begin is given for a specific location counter, 
only the first one is used. Each of the others causes an 
error message to be issued and is printed as a com- 
ment, but is otherwise ignored. 
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A BEGIN may appear anywhere in the program re- 
gardless of the location counter in control. 

Note that if the blank location counter is set to a 
value other than zero by the operation 

BEGIN , expression 

the USE pseudo-operation with a blank variable field 
must precede the first instruction of the deck. 

The order in which location counters are used is 
illustrated in the example: 

instruction 1 

BEGIN A,* 

USE A 

instruction 2 

instruction 3 

BEGIN C,* 

instruction 4 

instruction 5 

USE // 

instruction 6 

instruction 7 

USE B 

instruction 8 

instruction 9 

USE C 

instruction 10 

END 
In this sequence, instruction counters are used in the 
order: blank, A, C, B, and //. At load time, the se- 
quence of instructions will be: 

instruction 1 

instruction 2 

instruction 3 

instruction 10 (instruction 4 will be 
overlaid ) 

I instruction 8 (instruction 5 will be 

I overlaid ) 

instruction 9 

instruction 6 

instruction 7 

The ORG Pseudo-Operation 

The ORG ( Origin ) pseudo-operation redefines the value 
of the current location counter. The format of the org 
pseudo-operation is : 



For example, the location counter is set at the sixtli 
location of the program by 



ORG 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


ORG 


Any expression 



The ORG pseudo-operation causes the current location 
counter to be reset to the value of the variable field. If 
there is a symbol in the name field, it is given this value. 

Absolute origins are permitted in a relocatable as- 
sembly. An origin is treated as absolute if the value of 
the variable field of the org pseudo-operation is con- 
stant. Thus, 

ORG 5000 

sets the location counter to 5000. In a relocatable as- 
sembly, references to symbols under the control of an 
absolute origin (org or begin) are absolute. 



START -I- 5 



where start is the first location of the program. 

An org terminates the effect of a log pseudo-opera 
tion by redefining the value of the current location 
counter and ensuring that this value is used as the 
next binary card origin. 

The LOG Pseudo-Operation 

The LOG pseudo-operation permits symbolic address- 
ing in segments of an object program that are to be 
loaded at one area of storage and then moved to, and 
executed from, another. It redefines the value of the 
current location counter but does not affect the load 
address. 

The format of the log pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LOG 


Any expression 



The current location counter is reset to the value 
specified in the variable field. If there is a symbol in 
the name field, it is givejn this value. 

However, binary card origins are not affected by 
the log pseudo-operation. They remain relative to the 
value of the location counter prior to the log, indi- 
cating the address at which the program segment is 
to be loaded. 

If another log is encountered when one is already 
in effect, the current location counter is set to the 
value specified in the new log. 

The LOG pseudo-operation may be used only if an 
absolute assembly (absmod) is specified on the sibmap 
control card. (See the publication IBM 7090/7094 
IBSYS Operating System: IBJOB Processor, Form 
C28-6389, for a discussion of the $ibmap control card. ) 

The effect of a log pseudo-operation must be termi- 
nated (see "The org Pseudo-Operation.") before a use 
pseudo-operation appears. Otherwise, the log will be 
terminated automatically and an error message issued 
because undesirable location counter values may 
result. 



Storage-Allocation Pseudo-Operations 

The storage-allocation pseudo-operations reserve core 
storage areas within the sequence of the program. 

The BSS Pseudo-Operationi 

The BSS ( Block Started by Symbol ) pseudo-operation 
reserves a block of consecutive storage locations and 
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may describe the data that will occiipy the block. The 
format of the bss pseudo-operation is: 



NAME FIELD 



1, A syitibol, or 

2, Blanks 



OPERATION 
FIELD 



BSS 



VARIABLE FIELD 



One or two subfields, 
separated by a comma: 

1. Any expression, 

2. Modal and dimensional 
information 



The BBS pseudo-operation increases the value of the 
current location counter by the defined value of the 
expression in the first subfield of the variable field. 
The expression may contain any symbol or constant. 
Relocatable symbols are given their assembly value, 
and this value becomes absolute. Control-section sym- 
bols are given a value of zero. If there is a symbol in 
the name field, its defined value is that of the location 
counter just before the increase. 

When the second subfield is used, a symbol must 
appear in the name field. This subfield supplies modal 
and dimensional information to the debugging dic- 
tionary about the data that will occupy the block. The 
second subfield must be used if the symbol in the 
name field also appears in the variable field of a keep 
pseudo-operation or if the full debugging dictionary 
is specified in the variable field of a $ibmap card. ( See 
the publications IBM 7090/7094 IBSYS Operating 
System: IBJOB Processor Debugging Package, Form 
C28-6393 and IBM 7090/7094 IBSYS Operating Sys- 
tem: IBJOB Processor, Form C28-6389.) The format 
for this subfield is: 

mode ( di, d2, d.s ) 
where di, d2, and ds are the dimensions, if any, of the 
anay denoted by the symbol in the name field, and 
mode is one of the following: 

O Octal 

F Floating-point number 

X Fixed-point number 

D Double-precision floating-point number 

J Comple): number 

L Logical 

S Symbolic instruction 
C Symbolic command 
H Alphameric 

If an entry for mode is not one of the nine recognized 

letters above, the mode is assumed to be octal. If an 

entry for dimension is not a decimal integer, an error 

message is issued. 

When the second subfield is not used, it is assumed 
that the mode is octal and the dimension is 1. 

For example, in the sequence 



ALPHA 


lORT 


BETA„4 


BETA 


BSS 


4 


GAMMA 


lORT 


DELTA„6 



if ALPHA has been assigned to location 1001, beta 
will be assigned to location 1002 and gamma to loca- 



tion 1006. Thus, four locations are reserved for an 
array whose first element is at location beta; and an 
entry, specifying that this array is one-dimensional 
and that its elements are octal numbers, is made into 
the debugging dictionary. 

In addition to reserving four locations, the instruc- 
tion 

BETA BSS 4,F(2,2) 

indicates to the debugging dictionary that the data to 
occupy this area is a 2 by 2 array of floating-point 
numbers. 

The area reserved by the bss pseudo-operation is 
not zeroed. 

The BES Pseudo-Operation 

The BES (Block Ended by Symbol) pseudo-operation 
also reserves a block of consecutive storage locations 
and may describe the data that will occupy the block. 
The format of the bes pseudo-operation is: 



NAME FIELD 



1, A symbol, or 

2. Blanks 



OPERATION 
FIELD 



BES 



VARIABLE FIELD 



One or two subfields, 
separated by a comma: 

1. Any expression, 

2. Modal information 



The expression in the first subfield of the variable 
field may contain any symbol or constant. Relocatable 
symbols are given their assembly value, and this value 
becomes absolute. Control-section symbols are given 
a value of zero. 

The BES pseudo-operation functions almost identi- 
cally to a BSS pseudo-operation except that the symbol 
in the name field is defined after the location counter 
increases and thus refers to the first word following 
the reserved block. 

A symbol must appear in the name field of a bes 
pseudo-operation if the second subfield of the vari- 
able field is used. This subfield has the same use as it 
does in the bss except that it specifies modal informa- 
tion only. (If dimensional information is given, it is 
ignored. ) Thus an entry in the second subfield of the 
variable field of a bes instruction consists of one of the 
letters o, f, x, d, j, l, s, c, or h, as described in the 
discussion of the bss pseudo-operation. If the entry for 
mode is omitted or is a symbol other than the nine 
listed above, the mode is assumed to be octal. 

For example, in the sequence 

I ALPHA lORT BETA„4 

, BETA BES 4 

I GAMMA lORT DELTA„4 

if ALPHA has been assigned to location 1001, both beta 
and GAMMA will be assigned to location 1006 and four 
locations will be reserved for octal data. 

In addition to reserving four locations, the instruc- 
tion 
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BETA BES 4,X 

supplies the debugging dictionary with the informa- 
tion that the data to occupy this area is in the fixed- 
point mode. 

The difference between bes and bss can be seen in 
the sequence of instructions 



ALPHA 



BES 
CLA 



25 
BETA 



which is eiBFectively the same as 



BSS 
CLA 



25 
BETA 



ALPHA 

The area reserved by the bes pseudo-operation is not 
zeroed. 

The EVEN Pseudo-Operation 

The EVEN pseudo-operation forces the current location 
counter to an even value to ensure an even address for 
the next instruction or data— usually a double-precision 
floating-point number. It is used only in the 7094 and 
has no effect in the 7090 or 7094 ii. The format of the 
EVEN pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


EVEN 


Ignored 



In a 7094 relocatable assembly, the even pseudo- 
operation causes the instruction 

AXT 0,0 

to be inserted at load time if the load address of the 
AXT instruction is not even. The axt instruction has no 
other effect on the program. 

In a 7094 absolute assembly, the even pseudo- 
operation causes the insertion of the instruction 

AXT 0,0 

at assembly time so that it is available at load time in 
the event that the axt instruction load address is not 
even. The axt instruction has no other effect on the 
program. 

The LDIR Pseudo-Operation 

The LDIR ( Linkage Director ) pseudo-operation places 
the Linkage Director in the program at the point of 
the LDIR. The format of the ldir pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LDIR 


Ignored 



The Linkage Director is a unique location for each 
assembly, which is one beyond the final value of the 
location counter if the ldir pseudo-operation is not 
used. If the ldir pseudo-operation is used with a sym- 
bol in the name field, the programmer may refer to the 
Linkage Director. 



The Linkage Director serves as a cross-reference for 
the CALL and save pseudo-operations. If neither the 
LDIR nor LORG pseudo-operations is used, the Linkage 
Director precedes the Literal Pool. If the ldir pseudo- 
operation appears more than once, only its first appear- 
ance is effective. 

For example, 

ALPHA LDIR 

would cause 

ALPHA PZE 

BCI l,deckname 

to be generated. The second subfield in the bci opera- 
tion is the deckname specified on the sibmap card ( see 
the publication IBM 7090/7094 IBSYS Operating Sys- 
tem: IB JOB Processor, Foim C28-6389). 

The COMMON Pseudo-Operation 

The COMMON pseudo-operation has been preserved 
solely for compatibility with existing programs. When 
used together with the pseudo-operation 

CONTRL // 
it reserves a storage area called blank common for use 
with such programs. The format of the common 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


COMMON 


One or two subfields separated 
by a comma: 

1. Any expression 

2. Modal and dimensional in- 
formation 



The first subfield of the variable field may contain 
any symbol or constant. Relocatable symbols are given 
their assembly value, and this value becomes absolute. 
Control-section symbols are given a value of zero. 

The common operation causes : 

1. Location counter // to be activated 

2. A symbol in the name field, if any, to be defined 
as having the current value of location counter // 

3. Location counter // to be increased by the defined 
value of the variable field expression 

4. The location counter in use prior to the common 
operation to be reactivated 

The effect of the sequence 

A COMMON E 

is equivalent to 



USE 


// 


BSS 


E 


USE 


PREVIOUS 



The second subfield of the variable field is used in the 
same way as the second subfield of the bss pseudo- 
operation. (See "bss Pseudo-Operation.") 
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Uteral-Posifioning Pseudo-Operations 

Two pseudo-operations, lorg and litorg, enable the 
programmer to determine the origin of the Literal 
Pool (see "Literals"). 

If neither of these pseudo-operations is used, the 
Literal Pool begins one location beyond the final value 
of the location counter in use at the end of a program. 
If more than one location counter is used by a pro- 
gram, the Literal Pool might overlay part of the pro- 
gram. For example, in the sequence 



USE 


Y 


BSS 


1 


USE 


X 


CLA 


= 1 


USE 


Y 


END 





the Literal Pool would begin at symbolic location B 
(one beyond the final value of location counter Y). 
Overlay also occurs if the // location counter is used 
but is not in effect at the end of the program. Specify- 
ing, the location of the Literal Pool with a lorg or a 
LITORG can eliminate this overlapping. 

If double-precision literals are used in a 7094 pro- 
gram, an EVEN pseudo-operation should precede a lorg 
or LITORG to ensure their entry at an even numbered 
address. 

The LORG Pseudo-Operation 

The LORG ( Literal Pool Origin) pseudo-operation con- 
trols the positioning of all literals used in a program 
that are not under control of a litorg pseudo-oper- 
ation. The format of the lorg pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LORG 


Ignored 



As a result of this pseudo-operation, the Literal Pool 
starts at the location of the lorg in the symbolic deck. 
This location is assigned the value of the symbol in 
the name field. For example, the sequence 





USE 


Y 


A 


BSS 


1 




USE 


X 


B 


CLA 


= 1 




USE 


Y 


C 


LORG 
END 





would place the beginning of the literal pool one be- 
yond symbolic location B and give it the symbolic 
name C. 

If more than one lorg is given, only the first is effec- 
tive. Duplicate literals under the control of a lorg 
are eliminated. 



The LITORG Pseudo-Operation 

The LITORG (Literal Origin) pseudo-operation enables 
literals used within a block of coding to be associated 
with that block. The primary use of this pseudo-oper- 
ation is to associate the literals used within a control 
section (see "Control Dictionary Pseudo-Operations") 
with that control section. 

The format of the litorg pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1 . A symbol, or 

2. Blanks 


LITORG 


Ignored 



All literals encountered prior to a litorg pseudo- 
operation (either from the beginning of the program 
or from a previous litorg) are placed in a pool start- 
ing at the location of the litorg. The beginning of 
the pool is assigned the symbol in the name field. For 
example, the sequence 



USE 


X 


CLA 


= 1 


ADD 


= 2 


LITORG 




USE 


Y 


CLA 


= 3 


ADD 


= 4 


LITORG 




USE 


X 


END 





would begin the first Literal Pool (containing 1 and 2 ) 
at symbolic location A and the second Literal Pool 
(containing 3 and 4) at symbolic location B. 

Any Hterals encountered following a litorg are posi- 
tioned at the next litorg or, if there is none, under 
the control of a lorg pseudo-operation. If there is 
neither a lorg nor another litorg, subsequent literals 
follow an *LORG generated immediately preceding the 
END card. 

Under litorg control, duplicate literals are elimi- 
nated within each litorg section. 



Data-Generating Pseudo-Operations 

Five pseudo-operations (oct, dec, bci, lit, and vfd) 
provide the programmer with a convenient means of 
introducing data expressed in a variety of forms into a 
program during assembly. Numbers introduced by 
these operations are often referred to as constants. A 
sixth pseudo-operation, dup, permits a sequence of sym- 
bolic cards to be duplicated a specified number of 
times. 

The OCT Pseudo-Operation 

The OCT (Octal Data) pseudo-operation introduces 
binary data expressed in octal form into a program. 
The format of the ocr pseudo-operation is: 



18 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OCT 


1. One or more octal inte- 
gers, separated by com- 
mas, or 

2. Blanks 



Each subfield in the variable field contains a signed 
or an unsigned octal integer of n digits, where n ^ 12, 
The only limit on the number of subfields is that they 
must all be contained in the variable field of one card. 

A blank variable field results in a word of all zeros. 

The OCT operation converts each subfield to a binary 
word. These words are assigned to successively higher 
storage locations as the variable field is processed 
from left to right. If a symbol is used in the name field, 
it is assigned to the first word of data generated. 

For example, each of the instructions 

ALPHA OCT 777777777777 

ALPHA OCT -777777777777 

ALPHA OCT -377777777777 

would result in a binary word of 36 consecutive ones 
at location alpha. 

In the instruction, 

ALPHA OCT 43,25,64 

the binary equivalent of octal number 43 would appear 
at location alpha, the binary equivalent of 25 at loca- 
tion ALPHA +1, and the binary equivalent of 64 at 

ALPHA + 2. 

The DEC f'seudo-Operation 

The DEC ( Decimal Data ) pseudo-operation introduces 
data expressed as decimal numbers into a program. 
The format of the dec pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


DEC 


1. One or more decimal data 
items, separated by com- 
mas, or 

2. Blanks 



The only limit on the number of subfields is that 
they must all be contained in the variable field of one 
card. 

A blank variable field results in a word of all zeros. 

The DEC operation converts each subfield to one or 
two binary words, depending on whether the decimal 
data item is single or double precision. These words 
are stored in successively higher storage locations as 
the variable field is processed from left to right. A 
symbol used in the name field is assigned to the first 
word of data generated. 

For example, the instruction 

ALPHA DEC 43,25 



would result in the binary equivalent of decimal num- 
ber 43 appearing at location alpha and of decimal 
number 25 appearing at location alpha + i. 

The BCI Pseudo-Operation 

The BCI (Binary Coded Information) pseudo-operation 
introduces binary-coded decimal data into a program. 
Each data word generated consists of six 6-bit char- 
acters in standard bcd code. The format of the bci 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


BCI 


Two subfields, separated by 
a comma: 

1. Single-digit count or 
symbol, 

2. Alphameric data 



If a digit is used in the count subfield, it must be a 
single digit from 1 through 9. 

A null subfield indicates a count of ten. To accommo- 
date the full ten words of data on the card, the null 
subfield must be indicated by a comma in column 12. 

The data subfield contains any desired alphameric 
information (see Appendix E for the map bcd char- 
acter code). 

The length of the data subfield is determined by the 
number of six-character words specified in the count 
subfield. The immediate value of the symbol used in 
this subfield may also be used to determine the length 
of the data subfield. 

The comments field begins immediately after the 
end of the data subfield, and no blank character is 
needed to separate the data subfield from the com- 
ments field. Any part of the data extending beyond 
the limit of the data field is treated as comments. Blanks 
are inserted as required to fill the data subfield to the 
length specified by the count subfield. 

Thus, the bci pseudo-operation introduces data 
words into consecutive locations, the number of words 
generated being equal to the number in the count 
subfield. A symbol used in the name field is assigned 
to the first word of data generated. 

For example. 



ALPHA 



BCI 



2,bPROFITbRISEbINbPER- 
CENT 



would generate the data words profit rise, whereas 
IN PERCENT would bc commcuts. 

The VFD Pseudo-Operation 

Each VFD pseudo-operation generates no, one, or mort^ 
than one binary data words and assigns them to suc- 
cessively higher storage locations. The format of th(! 
VFD (Variable Field Definition) pseudo-operation is: 
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NAME FIKLD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


VFD 


Any number of subfields, 
separated by commas 



Each subfield o£ the variable field generates zero, one, 
or more than one bits of data. Thus, the unit of informa- 
tion for this pseudo-operation is the single bit. 

E^ach subfield may be any one of three types: octal 
(Boolean), alphameric, or symbolic (including deci- 
mal integers). 

The subfield of the vfd pseudo-operation consists of: 

1. The type letter 

a. The letter O signifies an octal (Boolean) field. 

b. The letter H signifies an alphameric field. 

c. The absence of either O or H signifies a sym- 
bolic or decimal field. 

2. The bit count — either a decimal integer or an 
immediate symbol specifies the number of bits to be 
generated by the subfield. If an immediate symbol is 
used, care should be taken to avoid confusion caused 
by the type letter. The maximum allowable bit count 
for a single subfield is 864. 

3. The separation character slash (/) 

4. The data item 

I a. In an octal subfield, the data item may be a 

Boolean expression or an octal number, 
b. In an alphameric subfield, the data item is a 
string of characters none of which is a comma 
or a blank. 

Ic. In a symbolic subfield, the data item is one 
expression. The item is taken modulo '2?^. 

Any number of subfields may be used. Successive 
subfields of the variable field are converted and packed 
to the left to form generated data words. If n is the bit 
count of the first subfield, the data item in that sub- 
field is converted to an n-bit binary number that is 
placed in the leftmost n positions of the first data word 
to be generated. If n exceeds 36, the leftmost 36 bits 
of the converted data item form the first generated 
data word and the remaining bits are placed in the 
first ( n — 36 ) bit positions of the second generated data 
word. 

Each succeeding subfield is converted and placed 
in the leftmost bit positions remaining after the pre- 
ceding subfield has been processed. If the total number 
of bit positions used is not a multiple of 36, the unused 
bit positions at the right of the last generated data 
word are filled with zeros. 

If the data item is a single signed octal integer of 
any length, the sign is recorded as the high-order bit 
of the specified bit group. 



If after conversion a symbolic or octal item occupies 
more than n bits, only the rightmost n bits of the con- 
verted data item are used. If the converted data item 
occupies fewer than n bits, enough zero bits are placed 
at the left of the converted data item to form an n-bit 
binary number. Neither condition is regarded as an 
error by the assembly program. 

The data item in a symboHc subfield is converted 
as a symbolic expression. Decimal integers must not 
exceed 32767. 

The data item in an octal subfield may be any valid 
Boolean expression. In addition, a signed or unsigned 
octal integer, which may exceed 18 bits, will be recog- 
nized and accepted by the assembly program. 

The data item in an alphameric subfield may consist 
of any combination of characters other than a comrtia 
or a blank. Each character is converted to its 6-bit 
binary code equivalent. If the converted data item 
occupies more than n bits, only the rightmost n bits 
are used. If the converted data item occupies fewer 
than n bits, sufficient 6-bit groups of the form 110000 
(the BCD code for blank) are placed at the left of the 
converted data item to form an n-bit binary number. If 
n is not a multiple of 6, the leftmost character or blank 
is truncated. None of these conditions is regarded as 
an assembly error. 

For example, the vfd pseudo-operation could be 
used to break up a 36-bit word as follows: Positions S 
and 1 through 9 must contain the binary equivalent of 
the decimal integer 895, positions 10 through 14 must 
contain the binary equivalent of the octal integer 37, 
positions 15 through 20 must contain the binary equiv- 
alent of the character C, and positions 21 through 35 
must contain the value of the symbol alpha. The in- 
struction to generate this word is 

VFD 10/895,O5/37,H6/C, 15/ALPHA 

The LIT Pseudo-Operation 

The LIT (Literal) pseudo-operation places data items 
from the subfields of the variable field into the Literal 
Pool in successively higher storage locations. 
The format of the lit pseudo-operation is: 



NAME FIELD 



Blanks 



OPERATION 
FIELD 



LIT 



VARIABLE FIELD 



Data subfields, separated by 
commas 



Rules for the contents of the data subfields are the 
same as those governing literals except that the equal 
sign ( = ) is omitted. 

A Literal Pool entry made using a lit pseudo-opera- 
tion is assumed to be double precision if the variable 
field generates only two consecutive words of data. If 
a double-precision entry is made in the Literal Pool 
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by either a lit pseudo-operation or a double-precision 
literal, the number is placed in an even location rela- 
tive to the beginning of the Literal Pool. (In this re- 
spect, the assembly program does not distinguish 
double-precision floating-point numbers from double- 
precision fixed-point numbers. ) 
For example, 



For example, the sequence 



LIT 



1,2 



causes the number 1 to be placed in an even location 
relative to the beginning of the Literal Pool (which 
can result in duplicate entries in the Literal Pool ) . 
The instruction 



LIT 



lEEl 



results in a double-precision entry beginning in an 
even location in the Literal Pool, but the instruction 

LIT 1EE1,2 

results in a three-word entry with the first word not 
necessarily entered into an even location. 

Thus, double-precision floating-point numbers may 
be used as constants if an even pseudo-operation is 
used immediately preceding the lorg operation or, if 
no LORG is present, immediately before the end pseudo- 
operation. 



The DUP Pseudo-Operation 

The DUP (Duplicate) pseudo-operation causes an in- 
struction or sequence of instructions to be duplicated. 
An important application is in generating tables. The 
format of the dup pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


DUP 


Two subfields, separated by 
a comma: 

1. An expression 

2. An expression 



The first subfield represents instruction count, and 
the second subfield represents iteration count. Integers 
are generally used in these subfields. Symbols in the 
instruction count and iteration count subfields are 
evaluated for their S-values. 

If m represents instruction count and n represents 
iteration count, the dup pseudo-operation has the effect 
of duplicating the next m instructions n times. 

The group of m instructions following the dup es- 
tablish the range of the dup. The effect of the dup 
pseudo-operation is that the set of m symbolic cards 
making up the range is copied n-1 times and placed in 
the symbolic deck behind the original set. (The name 
field of the symbohc card is duplicated. ) An iteration 
count of zero causes the entire range to be omitted. 



DUP 


2,3 


PZE 


X 


PZE 


Y 


iquence 
PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


Y 



With the sole exception of the end pseudo-operation, 
any operation may appear within the range of a dup, 
including another dup. 

If a DUP pseudo-operation occurs within the range 
of a preceding dup, the two (or more) dup pseudo- 
operations are said to be nested. As in most cases of 
nesting, the effect of nested dup pseudo-operations must 
be determined beginning with the innermost one and 
working out. If the explicit range (the instruction 
count) of the inner dup extends beyond the range of 
an outer dup, the implicit range of the outer dup is 
extended to the farthest point covered by the inner 
DUP. The first card to be processed after such a series 
of DUP pseudo-operations is the next card beyond both 
explicit and implicit dup ranges. 

For example, the operation 



DUP 



m,n 



duplicates the effect of the next m cards n times. 
In the nested dup pseudo-operations in the sequence 



DUP 
DUP 
PZE 
PZE 



1,2 
1,2 
X 
Z 



the single card to be duplicated by the outer dup is the 
inner dup, and the effect of the inner dup is actually the 
two operations 

PZE X 

PZE X 

The sequence generated when the outer dup is ex- 
panded is 



PZE 
PZE 
PZE 
PZE 
PZE 



X 
X 
X 
X 
Z 



where the last card in the sequence is the first card 
beyond both the explicit and implicit ranges of the 
outer DUP. 

In the sequence 



DUP 


3,2 


DUP 


1,2 


PZE 


X 


PZE 


Y 


PZE 


Z 
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The effect of the inner dup is the sequence 



PZE 
PZE 



The range of the outer dup includes the two instruc- 
tions resulting from the expansion of the inner dup 
plus the two instructions following, i.e., pze x and 

PZE Y. 



Thus, the 


expansion c 


)f tl 


sequence 








PZE 


X 




PZE 


X 




PZE 


X 




PZE 


Y 




PZE 


X 




PZE 


X 




PZE 


X 




PZE 


Y 




PZE 


Z 



outer DUP gives 



the 



The range of a dup that occurs within the range o£ 
another dup must be fixed before the outer dup is en- 
countered. This can be done by using the set pseudo- 
operation. (See the section "The set Pseudo- 
Operation.") For example, the sequence 

K 
K 

will result in an error message and assembly will be 
terminated. However, the iteration count may be vari- 
able. For example, the sequence 



SET 


1 


DUP 


2,2 


SET 


K-f-l 


DUP 


K,n 



K SET 


1 


DUP 


2,2 


K SET 


K-f-l 


DUP 


m,K 


valid and will be assembled ( 


le sequence 




K SET 


1 


DUP 


2,2 


K SET 


K + l 


DUP 


3,K 


PZE 


X 


PZE 


Y 


PZE 


Z 


ould result in 




PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 



The variable field of a dup pseudo-operation cannot be 
extended by use of the etc pseudo-operation. 



Symbol-Defining Pseudo-Operations 

MAP provides a group of pseudo-operations specifically 
designed to define the symbols that appear in their 
name fields. They are useful in a variety of program- 
ming applications, such as equating symbols to com- 
bine separately written program segments or changing 
parameters referred to symbolically throughout a pro- 
gram by redefining the symbol. 

The EQU and SYN Pseudo-Operations 

The EQU and syn pseudo-operations are identical. The 
format of the equ and syn pseudo-operations is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


EQU 

or 

SYN 


One or two subfields, 
separated by a comma : 

1. Any expression, 

2. Modal and dimensional 
information 



The EQU and syn pseudo-operations give the name 
field symbol the same definition — and the same struc- 
ture—as the expression in the first subfield of the 
variable field. Thus, if A is defined as X -h Y - Z and 
the instruction 

B EQU A 

is given, B is defined as X -h Y - Z. The instruction 

LCS EQU * 

defines lcs as having the current value of the location 
counter. 

Wlien the second subfield is used, it supphes to the 
debugging dictionary modal and dimensional informa- 
tion about the symbol in the name field. This sub- 
field must be used if the symbol in the name field 
also appears in the variable field of a keep pseudo- 
operation. (See the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Debugging Package, Form 
C28-6393. ) The format for this entry is 

mode ( di, d2, da ) 
where di, d2, and ds are the dimensions, if any, of the 
array denoted by the symbol in the name field, and 
mode is one of the letters o, f, x, d, j, l, s, c, or h, as 
explained in the discussion of the bss pseudo-opera- 
tion. 

If the mode is omitted or is a symbol other than the 
nine listed above, it is assumed to be octal. Dimensions 
must be decimal integers or an error message is issued. 

The NULL Pseudo-Operation 

The format of the null pseudo-operation is: 



NAME FIELD 



1. A symbol, or 

2. Blanks 



OPERATION 
FIELD 



NULL 



VARIABLE FIELD 



Ignored 
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The NULL pseudo-operation defines the symbol in the 
name field, if any, as having the current value of the 
location counter. The operation 

LCS NULL 

is equivalent to 

I LCS EQU * 

except that null is preferred. 

The MAX Pseudo-Operation 

The MAX pseudo-operation gives the symbol in the 
name field an absolute value equal to the expression 
in the variable field that has the maximum defined 
value. The format of the max pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


MAX 


Expressions, separated by 
commas 



The maximum value is computed as if all symbols were 
absolute. The comparison is made after negative values 
have been complemented. For example, the sequence 



BSS 
A MAX 
ALPHA EQU 


A 

100,ALPHA,ALPHA- 100 

150 


is equivalent to 





BSS 



150 



The MIN Pseudo-Operation 

The eflFect of the min pseudo-operation is opposite to 
that of MAX. The symbol in the name field is given an 
absolute value equal to the expression in the variable 
field having the minimum defined value. The format 
of the MIN pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


MIN 


Expressions, separated by 
commas 



The minimum value is computed as if all symbols were 
absolute. The comparison is made after negative values 
have been complemented. For example, the sequence 



A 
ALPHA 



BSS 

MIN 

EQU 



is equivalent to 



BSS 



100, ALPHA, ALPHA - 100 
150 
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The SET Pseudo-Operation 

The SET pseudo-operation causes the symbol in the 
name field to be defined immediately. The set pseudo- 
operation, which can be used to define symbols in both 
machine instructions and pseudo-operations, is often 
used to define the symbols in the variable fields of the 



DUP, VFD, IFT, and iff pseudo-operations. The format 
of the SET pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


SET 


Any expression 



Qualified symbols may not be used in the variable field. 

The symbol in the name field is immediately assigned 
the value ( called the S-value ) of the variable field ex- 
pression during the first pass of the assembly program. 
Thus, the set pseudo-operation enables the program- 
mer to use sequences of instructions in which decisions 
depend on the value assigned to a symbol during the 
first pass of the assembly program. It also permits sym- 
bols to be redefined repetitively. The value assigned 
to the symbol is always a 15-bit integer. 

Use of the set pseudo-operation is subject to the 
following conditions: 

1. Immediate symbols may not be qualified. 

2. An immediate symbol used in the variable field 
of a pseudo-operation affecting location counters ( such 
as Bss) assumes the final value assigned to it in the 
program. For example, the sequence 



A SET 


100 


BSS 


A 


A SET 


1000 


END 




is equivalent to 





BSS 1000 

3. An immediate symbol should not normally be 
given a name identical to an ordinary symbol, since 
doing so can result in multiple definition. 

An example of the use of the set pseudo-operation 
to assign a value to a symbol during the first pass of 
the assembly program is shown in the following se- 
quence. 



ALPHA 



SET 
VFD 



50 
ALPHA/BETA 



By using the set pseudo-operation, the value of 
alpha can be changed without altering the vfd in- 
struction. A similar use of immediate symbols is in 
making conditional assembly decisions with the iff/ift 
pseudo-operations. 

The SET pseudo-operation permits a symbol to be re- 
defined repeatedly for such programming functions as 
constructing tables and writing macro-operations. For 
example, in the sequence 



ALPHA 



ALPHA 



SET 
DUP 
PZE 
SET 



1 

2,9 

ALPHA 
ALPHA -1-1 



ALPHA is first assigned a value of 1 and then redefined 
nine times with its value incremented by 1 at each 
iteration. 
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Boolean PsGudo-Operations 

The Boolean pseudo-operations define symbols as 
Boolean quantities. 

The BOOL Psoudo-Operation 

The BOOL (Undesignated Boolean) pseudo-operation 
functions like the equ pseudo-operation except that the 
variable field expression is Boolean and the name field 
symbol becomes a Boolean symbol. The format of the 
BOOL pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


BOOL 


A Boolean expression 



BOOL defines the symbol in the name field as an 18-bit 
constant. Relocatable symbols or virtual symbols used 
in the variable field result in an error. Octal integers 
in the variable field may not exceed six characters. 



The RBOOi oind LBOOL Pseudo-Operations 

The format of the rbool (Right Boolean) and lbool 
(Left Boolean) pseudo-oj)erations is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


RBOOL 

or 
LBOOL 


A Boolean expression 



Relocatable symbols or virtual symbols used in the 
variable field result in an error. Octal integers in the 
variable field may not exceed six characters. 

These pseudo-operations are similar to bool except 
that the symbol in the name field is defined as right 
(left) Boolean. They are normally used to determine 
the correct machine operation for the special type D 
instructions ( sib, bnt, bft, iib, and rib ) . The following 
mechanism is used. 

1. If the expression in the variable field of an sib 
instruction is entirely left ( right ) Boolean, the instruc- 
tion is assembled as sil ( sir ) . Constants are considered 
to be both left and right Boolean. If the expression is a 
mixture of both left and right Boolean, sil is assembled 
but a vi^arning message is issued. 

2. If the variable field of an sil (sir) instruction is 
not purely left (right) Boolean, left (right) and un- 
designated Boolean, or purely undesignated Boolean, 
a warning message is issued. 

For example, following the instructions 



the instruction 










BFT 


X 


assembles as LFT 123 




BNT 


Y 


assembles as RNT 456 




IIB 


Z 


assembles as II R 321 




RIB 


Y-l-Z 


assembles as RIR 777 




SIB 


Y+Z 


assembles as SIL 323 



A warning message is issued for the last instruction 
(sib) because of the mixture of left and right Boolean. 



Conditional-Assembly Pseudo-Operations 

Two pseudo-operations provided by map enable the 
programmer to specify that the next instruction is to 
be assembled only if certain criteria are met. Another 
pseudo-operation, goto, may be used with the condi- 
tional-assembly pseudo-operations to extend their 
effect over more than one instruction. 

The IFT and IFF Pseudo-Operations 

TheiFT (If True) and iff (If False) pseudo-operations 
specify conditions that determine whether the next 
sequential instruction will be assembled. The format 
of the IFT and iff pseudo-operations is: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


Blanks 


IFT 


1, element— relational opera- 




or 


tor—element 




IFF 


2. If present, either of the 
words OR or AND, pre- 
ceded by a comma 



5C LBOOL 


123 


f RBOOL 


456 


I RBOOL 


321 



The IFT (iff) pseudo-operation assembles the next 
instruction if the condition expressed by the operation 
and the first subfield is met. 

A relational operator consists of one or two adjacent 
symbols signifying: 

= Equals 

= -1- Greater than 

= — Less than 

The elements at the left and right of these relations 

must not be qualified. The element is used in one of 

two ways: 

1. To represent a numerical value equal to its S-value 

2. To represent literal bcd information, in which case 
it is surrounded by slash ( / ) marks 

Interpretation of the relational operator depends on 
the context. If the elements represent bcd, the relation 
is a scientific collating sequence comparison. For ex- 
ample, 

IFT /A/=+/B/ 

is false and would therefore not permit assembly of the 
next instruction. However, 

IFT /A/=-/B/ 

is true and would permit assembly of the next instruc- 
tion. 
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Also, 

IFF // = /A/ 

compares blank to A and would permit assembly of 
the next instruction. 

If the elements represent a numeric quantity, the re- 
lation is a numeric comparison. The programmer must 
avoid noncomparable elements. 

Presence of the second subfield signifies that another 
iFT or IFF is to follow, in which case the combined effect 
of the two is either a logical or or a logical and. 

The S-value and not the definition is used in numeric 
evaluation of symbols. The set pseudo-operation may 
be used to control iff or ift pseudo-operations, as in 
the sequence 



K 



SET 
IFT 



4 
K = 4 



This statement is true, and the next instruction will be 
assembled. 

The fact that the conditional assembly extends over 
only one instruction is not a serious restriction, since 
the following instruction may be another ift or iff 
pseudo- operation, a goto pseudo-operation, or a 
macro-operation that expands to any length (see the 
section "Conditional Assembly in Macro-Operations"). 

The variable field of an iff or ift pseudo-operation 
may not be extended by using the etc pseudo-opera- 
tion. 

The GOTO Pseudo-Operation 

The GOTO pseudo-operation, when used with an ift 
or iff pseudo-operation, provides the map programmer 
with a method for either assembling or skipping 
blocks of instructions. The format of the goto pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


GOTO 


One or two subfields, 
separated by a comma : 

1. Symbol, which may be 
followed by a comma when 
used alone, 

2. The word BLANK, which 
may be followed by a comma 



The goto pseudo-operation causes all instructions 
following it, up to but not including the instruction 
whose name field contains the symbol specified in the 
variable field of this pseudo-operation, to be skipped 
during assembly. 

If the BLANK option is present, the symbol in the 
variable field will not be entered into the dictionary 
but will appear on the listing. Therefore, the symbol, 
which may be completely numeric, may be reused. 

If the variable field does not end with a comma, the 
skipped instructions are hsted as comments. If the 



terminating comma is present, listing of skipped in- 
structions is suppressed. 
For example, the sequence 



CLA X 

IFT A = l 

GOTO LCS 

STO Z 



CLA 
TSX 



B 
SUB,4 



LCS 
would produce 

LCS 
if A had previously been defined as 1, and 



CLA 
TSX 



X 

SUB,4 



CLA 
STO 



CLA B 

LCS TSX SUB,4 

if A had been defined as some value other than 1. 

In this example, the instructions omitted would be 
listed and lcs would be entered into the dictionary. 
Alternate forms would be 

GOTO LCS,BLANK ( LCS not entered, cards listed ) 

GOTO LCS, (LCS entered, no list) 

I GOTO LCS,BLANK, ( LCS not entered, no list ) 

If a GOTO occurs within a macro-definition and the 
referenced symbol is outside the definition, only the 
instructions between the goto and the endm pseudo- 
operation are skipped. If a goto references past an 
iRP pseudo-operation, only the instructions between 
the GOTO and the irp are skipped. 



Symbol-Qualifying Pseudo-Operations 

MAP provides two pseudo-operations, qual and endq, 
that enable a programmer to qualify symbols within 
sections of a program. 

The QUAL Pseudo-Operation 

All symbols between the qual pseudo-operation and 
its associated endq pseudo-operation are qualified. The; 
format of the qual pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


QUAL 


Symbol 



The symbol in the variable field qualifies all symbols 
defined within the section controlled by the qual pseudo- 
operation. References to a symbol defined in a qualified 
section from within the same section need not be qual 
ified. References from outside the section are qualified 
by placing the section symbol (variable field symbol 
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of the QUAL pseudo-operation) in front of a connecting 
dollar sign followed by the desired symbol. For ex- 
ample, the symbol qssalpha refers to symbol alpha 
defined in qualified section QS. The notation sbeta re- 
fers to symbol beta, which is not qualified. The un- 
qualified section effectively has a blank qualifier. 

Qualified sections may be nested to provide multiple 
qualification. The range (from a qual to its correspond- 
ing endq) of a lower-level qual must fall completely 
within the range of the next higher qual. A symbol is 
automatically qualified by any qualifiers of a higher 
level than the highest one specified in using the symbol. 
A multiply qualified symbol can be referenced without 
using all the quahfiers if enough qualifiers are given 
to determine the symbol uniquely. In any case, the 
qualifiers must be specified in the same order that nest- 
ing occurs within that section. 

A sequence illustrating qualification is 



A 



QUAL 

BSS 

CLA 

ENDQ 

QUAL 

BSS 

ENDQ 



Qualified 
Section H 



Qualified 
Section J 



In this case, if X is written as A or h$a, it refers to 
the first definition of A; X written as j$a refers to the 
second definition of A. 

In the sequence of nested qualification 



A 



A 



QUAL 


M 




\ 


BSS 


1 




1 


QUAL 


N 1 


Qualified 


f Qualified 


CLA 


X 


Section 


i Section M 


ENDQ 


N ( 


M$N 


\ 


ENDQ 


M 




/ 


BSS 


1 






CLA 


Y 







X written as A refers to the first definition of A; X 
written as $a refers to the second nonqualified A. 
Y written as A refers to the second A; Y written as 
MSA refers to the first A. 

In the more complicated sequence 





QUAL 


ONE \ 




A 


BSS 


1 


1 


A 


QUAL 
BSS 
CLA 
ENDQ 


Y > Section 
^qJONE$TWO ( 


f Quali- 
. fied 

Section 
i ONE 




CLA 


Y 


' 




ENDQ 


ONE 1 






QUAL 


THREE ^ 




A 


BSS 


1 j 


Quali- 




QUAL 


TWO / Qualified ( 


^ fied 


A 


BSS 


1 > Section ( 


Section 




ENDQ 


TWO \ THREE$TWO ' 


1 THREE 




ENDQ 


THREE 1 


1 



X refers to the first A by one$a; to the second A by A, 
by two$a, or by one$two$a; to the third A by threesa; 
and to the fourth A by thbee$two$a. 



Y refers to the first A by A or by one$a; to the second 
A by TWOSA or by one$two$a; to the third A by 
threesa; and to the fourth A by three$two$a. In this 
sequence, the two sections two are distinct and not 
separate parts of the same section. The first is section 
ONE$TWO, and the second is section threestwo. 

The ENDQ Pseudo-Operation 

The format of the endq pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ENDQ 


Either: 

1. A symbol, or 

2. Blanks 



ENDQ delimits the range of the qualified section 
whose symbol is in the variable field of this instruction. 
If the variable field is blank, the innermost qualified 
section is terminated. However, a low-severity warning 
message is issued, since a variable field inadvertently 
left blank can result in errors when using nested quaH- 
fication. 

In nested qualified sections, a separate endq is re- 
quired to terminate each qualified section. Also, quali- 
fied sections must be terminated in order beginning 
with the lowest level section as shown in the following 
sequence, or an error message will be issued. 
QUAL ALPHA 



QUAL 



QUAL 



ENDQ 



ENDQ 



ENDQ 



BETA 



GAMMA 



GAMMA 



BETA 



ALPHA 



Control-Section Pseudo-Operations 

Relocatable programs can be divided into segments. 
By dividing large programs into relocatable segments, 
individual segments can be coded and checked in 
parallel, with consequent savings in time. Also, a seg- 
ment can be modified without requiring reassembly of 
the entire program. 

The control-section pseudo-operations provide the 
means for making references to and from such seg- 
ments, ibldr makes the cross-references among pro- 
gram segments that are assembled separately but 



26 



loaded together. (For further information, see the 
pubhcation IBM 7090/7094 IBSYS Operating System: 
IBJOB Processor, Form C28-6389.) 

Each program segment is a control section. In addi- 
tion, sections within segments may be designated as 
control sections by the programmer. 

IBLDR treats control sections as being variable. A 
control section may be replaced by another control 
section or even deleted entirely. If more than one 
control section is given the same designation, generally 
only the first control section is retained. 

An EVEN appearing within a control section must 
have the same relative location as the beginning of 
the control section. This will result in the first loca- 
tion of the control section being assigned an even 
location at load time. Thus, an instruction or data 
within a control section will be assigned to an even 
location if it appears an even distance from the con- 
trol section origin. 

The CONTRL Pseudo-Operation 

The CONTRL pseudo-operation designates a program or 
a part of a program as a control section. The format of 
the CONTRL pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VABIABLE FIELD 


Symbol 


CONTRL 


One of the following: 

1. A location counter sym- 
bol, or 

2. A qualification symbol, or 

3. Two subfields, separated 
by a comma, each contain- 
ing an ordinary symbol 



The CONTRL pseudo-operation delimits the control 
section named in the name field in accordance with 
the contents of the variable field. If a location-counter 
symbol is used in the variable field, all instructions 
under control of the specified location counter are 
delimited. The blank location counter cannot be used 
as a control section. If a qualification symbol is used, 
all instructions between the specified qual pseudo- 
operation and its associated endq pseudo-operation are 
delimited. If two subfields are used, all instructions are 
delimited beginning at the location specified by the 
first symbol and ending at, but not including, the lo- 
cation specified by the second symbol, contrl pseudo- 
operations that refer to absolute symbols, or to loca- 
tion symbols whose definitions depend on an absolute 
origin within a relocatable assembly, are discarded 
and an error message is issued. An error message will 
also be given if a qualification symbol or location 
counter symbol defining a control section falls under 
an absolute origin. If the absolute origin occurs within 
the control section, no diagnostic will be given and 
relocation errors may occur during loading. 

If there is no symbol in the name field, the first sym- 
bol in the variable field is taken as the external name 



of dae control section and a low-severity message is 
issued. The length of a control section is always the 
diflFerence between the value of the location counter in 
control at the end of the section and its value at the 
beginning of the section. Hence, the use of org or use 
pseudo-operations within control sections may result 
in incorrect length calculations, in eflFect, "losing" in- 
structions from the section. Text which has been 
placed within a control section by use of an org 
pseudo-operation cannot be deleted. Therefore, if sev- 
eral of such control sections with the same external 
name occur, the text from the last one encountered 
during loading will be used. If all of such control 
sections with the same external name are deleted, ex- 
ecution will be suppressed because of the resulting 
virtual reference which cannot be defined. 

The CONTRL pseudo-operation may appear anywhere 
in the program. In an absolute assembly, a low-severity 
error message is printed, but contrl is otherwise 
ignored. For example, 

X CONTRL A,B 

defines the portion of the program from A to, but not 
including, B as control section X. 

Control sections may be nested. 

To obtain the blank common area, as used by 7090/ 
7094 FORTRAN IV, an instruction of the form 

CONTRL // 

must be used. For example, in the sequence 

CONTRL // 
USE A 



USE 



USE 


// 


BSS 


20 


USE 


C 



USE 



END 



the blank common counter // will have its initial lo- 
cation defined as the last value reached by location 
counter C. The area under control of the // counter is 
a control section. 

The ENTRY Pseudo-Operation 

The entry pseudo-operation provides a reference from 
outside a program segment to a point within the pro- 
gram segment. The format of the entry pseudo-opera- 
tion is: 
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NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, 

or 

2. Blanks 


ENTRY 


Symbol 



The name field symbol becomes the external name of 
the entry point. The variable field symbol is the in- 
ternal name of the entry point and must be an ordinary 
symbol, although it may be qualified. If the name field 
is blank, the variable field symbol serves as the external 
name. If the variable field symbol is qualified, the (left- 
most) qualifier is used. For example, 

ALPHA ENTRY BETA 

sjDecifies that alpha is the external name of an entry 
point into this program from another program and that 
BETA is the internal name of this entry point. 

If an ENTRY pseudo-operation refers to either an 
absolute symbol, a symbol that was defined by an 
EQU or SYN pseudo-operation, or a location symbol 
whose definition depends on an absolute origin within 
a relocatable assembly, it is discarded and an error 
iTiessage is issued. 



File-Description Pseudo-Operations 

Two pseudo -operations are provided by map for spec- 
ifying input/output file requirements in relocatable 
assemblies. These pseudo-operations describe files that 
are used in conjunction with Library iocs. (See the 
pubHcation IBM 7090/7094 IBSYS Operating System: 
Input/Output Control System, Form C28-6345. ) 

iBLDB, generates a file control block and assigns the 
file to a buffer pool. File control blocks described in one 
program segment may be referenced in other segments. 
If the same file is described more than once, only the 
first description is effective. 

The FILI: Pseudo-Operation 

The FILE psemdo-operation enables the programmer to 
specify input/output file requirements. The file 
pseudo -operation causes generation of a sfile card, as 
well as any $etc cards needed. The format of the file 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


FILE 


External file name, options, . . . 



The symbol in the name field of the file pseudo- 
operation is the internal name of the file used by the 
i:)rogrammer within his program. Whenever this name 
appears in the variable field of an instruction, the re- 
locatable reference is to the generated file control 
block for this file. 



Tlie first subfield of the variable field is the external 
file name. The order of the subsequent subfields is 
arbitrary. 

In describing the subfields, options that may be in- 
cluded or omitted are shown in brackets. When an 
option is not specified, the standard option, which is 
shown underlined, is assumed. Braces indicate that a 
choice of the enclosed options is to be made by the 
user. Options are shown in all upper-case letters in the 
form in which they must be specified. 

External File Name is an alphameric literal of up to 
18 characters used to determine equivalence between 
files. This subfield must be specified as the first subfield 
in the variable field. It may be null ( the variable field 
may start with a comma ) , in which case the six- 
character name field ( left- justified with trailing blanks ) 
is inserted as the external name. 

Unit- Assignment Option 

[, primary unit] [, secondary unit] 

Two symboHc units may be specified for each file: the 
primary unit, and a secondary unit to be used as a reel- 
switching alternate. The format used for these speci- 
fications is indicated below, where the following nota- 
tion is used: 

X a real channel (specified by one of the letters A 

through H) 
P a symbolic channel (specified by one of the letters S 

through Z) 
I an inter system channel ( specified by one of the letters J 

through Q) 
k a unit number (specified by one of the numbers 

through 9) 
a access mechanism number (specified by the number 0) 

m module number (specified by one of the numbers 

through 9) 
s data channel switch or interface (specified by either of 

the numbers or 1 ) 
M model number of 729 Magnetic Tape Unit ( specified by 

II, IV, V, or VI) 
D 1301 Disk Storage ( specified by the letter D ) 
N 7320 Drum Storage (specified by the letter N) 
H 7340 Hypertape Drive (specified by the letter H) 
The following format is used for assigning units: 

EFFECT 

Use any available unit. 

Use any available 729 Magnetic Tape Unit 

of this model. 

Use any available unit on this channel. 

Use any available unit on this channel. 

Use kth available unit on this channel. 

Parentheses are required. 

Use any available 729 Magnetic Tape Unit 

of specified model on designated symbolic 

channel. 
P(k)M Use kth available 729 Magnetic Tape Unit 

of specified model on designated symbolic 

channel. Parentheses are required. 
I Use any available unit on channel I. This 

specification can be used for input and out- 
put units. 



SPECIFICATION 

blank 
M 

X 

P 

X(k) 

PM 
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IM Use any available 729 Magnetic Tape Unit 

of specified model on channel I. This speci- 
fication can be used only for output units. 

I(k) Use kth available unit on channel I. Paren- 

theses are required. This specification can 
be used for input and output units. 

I(k)M Use kth available 729 Magnetic Tape Unit 

of specified model on channel I. Paren- 
theses are required. This specification can 
be used only for output units, 

I(k)R Use kth available unit on channel I, and re- 

lease unit from reserve status after use. 
Parentheses are required. 

XDam/s Use 1301 Disk Storage on channel X, 

access mechanism number a (which must 
be 0), and module number m. 

XNam/s Use 7320 Drum Storage on channel -X, 

access mechanism a (0), module number 
m (0, 2, 4, 6, 8) and data channel switch 
setting s (0, 1 ) . 

XHk/s Use 7340 Hypertape Drive on channel X, 

unit number k, and data channel switch s. 

IN, INI, IN2 Use the system input unit (SYSINl) and 

the alternate system input unit (SYSIN2) 
as the primary and secondary units respec- 
tively. 

OU, OUl, C)U2 Use the system output unit ( SYSOUl ) and 

the alternate system output unit ( SYSOU2 ) 
as the primary and secondary units respec- 
tively. 

PP, PPl, PP2 Use the system peripheral punch ( SYSPPl ) 

and the alternate system peripheral punch 
(SYSPP2) as the primary and secondary 
units respectively. 

UTk Use system utility unit number k. 

CKk Use system checkpoint unit number k. 

RDX Use card reader on channel X. 

PRX Use printer on channel X. 

PUX Use card punch on channel X. 

INT File is internal. 

* An asterisk in the secondary unit field in- 

dicates that the secondary unit of a file is 
to be any unit on the same channel and of 
the same model as the primary unit. 

NONE No units are assigned. A file control block 

is generated but does not refer to a unit 
control block. 



File-Mounting Option 

r( MOUNT /") 
UNREADY } and/or 

L(defb:r \J 



"(MOUNTi) 
» ^READYi } 
_ JDEFERi ) 



] 



The file-mounting option governs the on-line message 
to the operator indicating the impending use of an 
input/output unit. The first form applies to both units; 
the second applies to the primary unit when i = l and 
to the secondary unit when i = 2. Two standard options 
are indicated— one is for units assigned to system unit 
functions (ready) and the other is for nonsystem units 
(mount). 



The eflFects of these operations are: 

MOUNT A message is printed before execution, and a 

stop occurs for the required operator action. 
MOUNT is the standard option for nonsystem 
units. 

READY A message is printed before execution, but no 

stop occurs. READY is the standard option for 
all input/output units assigned to system unit 
functions. 
DEFER A message and operator stop are deferred until 

the file is opened by the IOCS calling sequence. 
TSX .OPEN, 4 

PZE internal file name 

The i form of this option overrides for unit i any 
general option specified. 

As an example of the file-mounting option. 
MOUNTl, DEFER2 
causes the mount action for the primary unit and the 
DEFER action for the secondary unit. 



tion 



Operator File-List Opti 

L* / NOLIST \ J 

LIST This file will appear in the operator's mount- 

ing instructions. 

NOLIST No message will be printed unless the 

DEFER oi)tion has been specified. 

File-Usage Option 

r- /INPUT 
j OUTPUT 
* ) INOUT 
_ I CHECKPOINT 



INPUT 

OUTPUT 

INOUT 



CHECKPOINT 

(orCKPT) 



(orCKPT);_ 

This is an input file. 
This is an output file. 

This file may be either an input or an 
output file. The object program sets 
the appropriate bits in the file block. 
The file is initially set at input. 
This is a checkpoint file. 



Block-Size Option 

[, BLOCK = xxxx (or, BLK=xxxx)] 
xxxx is an integer (0-9999) that specifies block size for 
this file. If the block-sequence and/or check-sum op- 
tions ( see below ) are specified, a word must be added 
in determining block size. If the block option is 
omitted, the assembly program assumes a block size 
of 14 for BCD or mxbcd files and 256 for bin and mxbin 
files. 

Activity Option 
[, ACT = xx] 
XX is an integer (0-99) that specifies activity of this 
file in relation to other files. If the activity subfield is 
omitted, activity is assumed to be 1. The activity 
value is used in determining the number of input/ 
output buffers assigned to each buffer pool in the object 
program. 



MAP Pseudo-Operations 29 



Reel-Handling Option 



"(ONEBEEL 
» \ MULTIREEL 
_( (or REELS) 

ONEREEL 
MULTIREEL 

(or REELS) 



i] 



for unlabeled files only 



r \ NOSEARCH 1 1 
t I SEARCH \ J 
NOSEARCH 



SEARCH 



No reel switching should occur. 
Reel switching will occur. Every out- 
put file will switch reels if an end-of- 
tape condition occurs. 

for labeled files only 

If an incorrect label is detected when 
opening an input file, IOCS causes a 
stop for operator action. 
If an incorrect label is detected, IOCS 
enters a multireel search for the file 
with the desired label. 



File-Density Option 

(highI 
\low 

200 
J556 
,800 _ 

HKJH Tape-density switch is assumed to be set so that 
execution of an SDH will result in using correct 
density. 

LOW Tape-density switch is assumed to be set so that 

execution of an SDL will result in using correct 
density. 

200 Tape density switch is assumed to be set so that 

execution of an SDL will result in a file-record- 
ing density of 200 cpi. 

556 Tape density switch is assumed to be set so that 

execution of an SDL will result in a file-record- 
ing density of 556 cpi. 

800 Tape density switch is assumed to be set so that 

execution of an SDH will result in a file-record- 
ing density of 800 cpi. 
If a system unit is assigned to this file, system set den- 
sity supersedes the density specified by these options. 



Mode Option 

|MXBCDr 
[MXBIN }. 



'iMXBCDr 
LlMXBIN J J 



BCD File is in BCD mode. 

BIN File is in binary mode. 

MXBCD File is in mixed mode, and first record is 

BCD. 
MXBIN File is in mixed mode, and first record is 

binary. 

Label-Density Option 
n ^SLABEL ^ 

Jhilabel ( 

) LOLABEL ( 
L^FLABEL ; 
SLABEL All header label operations performed at 

installation standard density, which is 

currently high density. 
HILABEL All header label operations performed at 

high density. 
LOLABEL All header label operations performed at 

low density. 
FLABELi All header label operations performed at 

same density as file. 



Regardless of these options, the label pseudo-opera- 
tion must be used to specify a labeled file. If label 
density is not specified, all label options are performed 
at the density that is high density at the particular 
installation. 

Block-Sequence Option 

iNOSEQ )■ 
SEQUENCED 



EiNOSEQ )~1 

{SEQUENCED 
((orSEQ) \J 
NOSEQ 



SEQUENCE 

(orSEQ) 



Block-sequence word neither checked if 
reading, nor formed and written if 
writing. 

Block-sequence word checked if read- 
ing, or formed and written if writing. 

Check-Sum Option 

rmocKSUMM 

nCKSUM U 

NOCKSUM Check sum neither checked if reading, 

nor formed and written if writing. 
CKSUM Check sum checked if reading, or 

formed and written if writing. 
Check-sum options may not be specified unless a 
block-sequence option has been specified. 
Checkpoint Option 

r { NOCKPTS 1 1 

L'JCKPTS U 

NOCKPTS No checkpoints initiated by this file. 

CKPTS Checkpoints initiated by this file. 

Checkpoint-Location Option 

[, AFTER LABEL] 
Checkpoints are written following the label on this file 
when reel switching occurs. If ckpts is specified and 
this field is omitted, checkpoints are written on the 
checkpoint file when reel switching occurs. 
File-Close Option 
• /SCRATCHY -1 



i PRINT 
PUNCH 
HOLD 

SCRATCH 
PRINT 



File is rewound at end of application. 
File is to be printed and is rewound and 
unloaded at end of application. PRINT 
will appear in on-line removal message 
at end of execution. 
PUNCH File is to be punched and is rewound 

and unloaded at end of application. 
PUNCH will appear in on-line removal 
instructions. 
HOLD File is to be saved and is rewound and 

unloaded at end of application. HOLD 
will appear in on-line removal instruc- 
tions. 
If the unit assigned is system input unit 1, system out- 
put unit 1, or system peripheral punch unit 1, the unit 
will not be rewound and the removal message will not 
be printed. 
Starting Cylinder-Number Option 
I CYLINDER =xxx (or, CYL = XXX )] 
XXX is the number (000-249 for disk, 000-009 for drum) 
of the starting cyhnder for this file. The equals sign is 
required. When disk or drum storage is specified for 
a file, the starting cylinder number must be specified 
by the user. 



30 



Cylinder-Count Option 

[, CYLCOUNT = XX ( or, CYLCT = xxx ) ] 
XXX is the number (000-250 for disk, 000-010 for drum) 
of consecutive cylinders to be used by this file. The 
equals sign is required. When disk or drum storage is 
specified for a file, cylinder count must be specified 
by the user. 

Disk W rite-Checking Option 
[, WRITECK] 
Write-checking is performed after each disk-write or 
drum-write sequence for this file. 

Hypertape Reel-Switching Options 

-/IfflFP ^-| 
; HRNFP f 
JHNRFP I 
LUINRNFP^ J 
These options may be used in conjunction with the 
Hypertape option, hyper, where reel switching is hkely 
to occur. If any of these options are used but hyper 
is not specified, a warning message is issued. 
The effects of these options are: 

HRFF Hypertape, rewind, file protect. 

HRNFP Hypertape, rewind, no file protect. 

HNRFP Hypertape, no rewind, file protect. 

HNRNFP Hypertape, no rewind, no file protect. 

Five subfields provide information for cross-check- 
ing by iBLDR. These subfields, the conversion, block- 
size check, nonstandard label routine, Hypertape, and 
pool-attachment options, are not placed on the $file 
card. 

Conversion Option 

E\ NOPICVN / "1 
\ REQHCV \ 
/OPTHCV ^ J 

NOHCVN Alphameric-to-BCD conversion routine not 

necessary. File may not be assigned to 
card equipment. 

REQHCV Alphameric-to-BCD conversion routine re- 

quired. File must be assigned to card 
equipment. 

OPTHCV Alphameric-to-BCD conversion optional. 

Regardless of the conversion options specified, it is the 
responsibility of the programmer to provide the re- 
quired conversion routines. File may be assigned to 
any input/output device. 

Block-Size Check Option 

rjMULTI = xxxxM 
L/MIN=xxxx \] 

MULTI =xxxx Block size is a multiple of xxxx. 

MIN=xxxx Minimum block size is xxxx. 

Only one of the block-size check options may appear. 
The quantity specified is used by ibldr to check the 
block size indicated by the block option. If neither 
option appears, block size is assumed to be exactly 
that specified by the block option. 
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Nonstandard-Label-Routine Option 
[ , NSLBL = symbol] 
The symbol is the name of a nonstandard-label routine;. 
If the label routine is part of the program segment 
being assembled, the label routine must be made a 
control section with the symbol used as its external 
name. If the label routine is not part of this program 
segment, the symbol must be a virtual symbol. 

Hypertape Option 
[ ,HYPER ] 
HYPER must be specified if a program requires Hyper- 
tape for a particular file. If reel switching may occur, 
the Hypertape reel-switching options may be used in 
conjunction with hyper, However, use of Hypertape 
reel-switching options without specifying hyper re- 
sults in a warning message. 

If a file may be attached to a Hypertape or a 729 
Magnetic Tape Unit, the hyper specification is not 
necessary. 

Pool- Attachment Option 

POOL I -] 
NOPOOL } J 

POOL This file is to be attached to a pool. 

NOPOOL A file control block is to be generated, but 

this file is not to be attached to a pool. 

If a checkpoint (or ckpt) is specified for the file- 
usage option, NOPOOL is automatically assumed. 

If the NOPOOL option is specified, it is assumed that 
the iocs initialization sequences of .defin and .ati^ac 
for this file will be executed by the object program 
prior to opening the file. (See the pubHcation IBM 
7090/7094 IBSYS Operating System: Input/Output 
Control System, Form C28-6345. ) 

Example of FILE pseudo-operation 
For example, the options for an input file might be 
specified in the instruction 

INPUT FILE ,A(1),READY,BLK = 20, 

556,HOLD 

Since the first subfield is null, the symbol input in the 
name field is regarded as the external name. The re- 
maining subfields specify the first available unit on 
channel 1, the file-mounting option, a block size of 20 
words, a file density of 556 characters per inch, and the 
file is to be saved and must be rewound and unloaded 
at the end of the application. 

The LABEL Pseudo-Operation 

The LABEL pseudo-operation enables the programmer 
to label a file and causes generation of the $label con- 
trol card. Whereas the fh^e pseudo-operation describes 
the file characteristics, label simply labels the file. The 
format of the label pseudo-operation is: 



MAP Pseudo-Operations 31 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol. 


LABEL 


Five subfields: 


or 




1. File name, 


2. Blanks 




2. File serial number or disk 
or drum Home Address-2, 

3. Reel sequence number, 

4. Retention period (in days) 
or date, 

5. File identification name 



The file name is an alphameric name of eighteen or 
fewer bcd characters. If this subfield is null ( the vari- 
able field begins with a comma), the symbol in the 
name field is inserted as the file name. If the name field 
is also blank, 000000 is inserted as the file name. 

The file serial number is an alphameric subfield of 
five or fewer characters, and it may be null. If the label 
is for a file on disk or drum, this subfield must contain 
two BCD characters to specify the Home Address-2. 
(For further information, see the pubHcation IBM 
1301, Models 1 and 2, Disk Storage and IBM 1302, 
Models 1 and 2, Disk Storage with IBM 7090, 7094, 
and 7094 II Data Processing Systems, Form A22-6785.J 
The reel-sequence number is a numeric subfield of 
four or fewer digits and it may be null. 

For retention period in days, four or fewer numeric 
characters are used. For date, two or fewer numeric 
characters represent the year, and three or fewer 
numeric characters represent the day of the year. The 
year and the day of the year are separated by the 
character / ( slash ) . 

The file identification name is an alphameric subfield 
of eighteen or fewer bcd characters. This subfield may 
contain blanks but not commas. A comma will termi- 
nate this subfield, and excessive subfields will be 
flagged as errors. This subfield may also be null. 

For example, 

LABEL INVOICE„241,63/248,PRIMARY FILE 

specifies that the invoice file be labeled, provides its 
reel-sequence number of 241, dates it as the 248th day 
of 1963, and specifies primaby file as the file identifica- 
tion name. 

The variable field of the label pseudo-operation 
must be; contained on one card. No etc cards may be 
used following label. 

The >^ariable field is checked for errors. If there are 
more than five subfields, the variable field is truncated, 
only the first five subfields are used, and a warning 
message is printed. If there are fewer than five sub- 
fields, an appropriate number of commas is supplied 
so that the «label card always has the required sub- 
fields and a warning message is printed. 

Each subfield is then checked for length except for 
the last one. Subfields that are longer than the specified 
maximums are truncated to the maximum number of 
characters allowed for each, and a format error 



message is printed. Numeric subfields are also checked 
for validity, and the presence of any nonnumeric char- 
acters causes a format error message to be printed. 



Operation-Defining Pseudo-Operations 

Three pseudo-operations that define symbols as opera- 
tion codes are provided by map. 

The OPD Pseudo-Operation 

The OPD (Operation Definition) pseudo-operation de- 
fines the symbol appearing in the name field as an 
operation code. The format of the opd pseudo-opera- 
tion is: 



NAME FIELD 



Symbol 



OPERATION 
FIELD 



OPD 



VARIABLE FIELD 



12-digit octal machine opera- 
tion code definition 



The 12-digit machine operation code definition in the 
variable field must be specified according to the gen- 
eral format given in Appendix C. 

The OPD pseudo-operation defines the symbol in the 
name field as an operation code. The symbol must be 
defined by the opd pseudo-operation before its use in 
an operation field. 

For example, 

ALPHA OPD 430106000500 

defines alpha as an operation code having the same 
effect as the machine instruction cla. 

The OPVFD Pseudo-Operation 

The OPVFD (Operation Variable Field Definition) 
pseudo-operation defines the symbol in the name field 
as the operation code represented by the expression 
in the variable field. The format of the opvfd pseudo- 
operation is : 



NAME FIELD 



Symbol 



OPERATION 
FIELD 



OPVFD 



VARIABLE FIELD 



From 1 to 36 subfields, sep- 
arated by commas 



The format of the variable field is the same as that 
given for the vfd pseudo-operation. The variable field 
expression must result in a 36-bit word having the 
format given in Appendix C. 

The symbol in the name field becomes the mnemonic 
operation code of the instruction. The symbol must be 
defined by opvfd before being used in an operation 
field. 

For example, 

ALPHA OPVFD 06/43,05/00,07/106,06/00, 

012/0500 

defines alpha as an operation code having the same 

effect as the machine instruction cla. 
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The OPSYN Pseudo-Operations 

The OPSYN (Operation Synonym) pseudo-operation 
equates the symbol in the name field to the mnemonic 
operation code in the variable field. The format of the 
OPSYN pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD : 


Symbol 


OPSYN 


Mnemonic operation code 



The mnemonic operation code in the variable field 
must be a valid operation code (i.e., a machine opera- 
tion code, a pseudo-operation code, a macro-operation 
code, or a code that has been defined previously by 
OPD, OPVFD, or another opsyn ) . 

If a previously defined operation code is redefined 
with OPD, OPVFD, or opsyn, a warning message is issued. 
For example, 

CLA OPSYN CAL 

redefines cla as cal. The message warns the program- 
mer of possible inadvertent redefinition of an existing 
operation code. 



Miscellaneous Pseudo-Operations 

The END Pseudo-Operation 

The END pseudo-operation signals the end of the sym- 
bolic deck and terminates assembly. The end operation 
must be present and must be the last card in the sym- 
bolic deck. The format of the end pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


END 


1. An element, or 

2. Blanks 



In a relocatable assembly, the value of the element 
in the variable field is the nominal starting point of the 
program segment. 

The END pseudo-operation performs the following 
functions in an absolute assembly: 

1. Any binary output waiting in the punch buffer is 
written out. 

2. A binary transfer card to which control is trans- 
ferred is produced. It has a transfer address that is the 
value of the expression in the variable field. 

If UNPNCH is in effect, no cards are punched. 

The ETC Pseudo^Operation 

The variable field of most instructions may be ex- 
tended over additional cards by using the etc pseudo- 
operation. The format of the etc pseudo-operation is: 



NAME FIELD 



Ignored 



OPERATION 
FIELD 



ETC 



VARIABLE FIELD 



Subfields, separated by com- 
mas, or partial subfields 



The ETC pseudo-operation appends its variable field 
as a continuation of the variable field of the previous 
instruction. The blank that separates the variable field 
from the comments field of a card is an end-of-card 
indicator and not an end-of-variable-field indicator. 
The number of etc cards in one group is generally lim- 
ited by the size of the resultant expression and/or the 
number of subfields. A variable-field expression is lim- 
ited to about 100 elements, operators, and/or subfields. 
No element of an expression may be split between 
two cards. For example, the instruction 



TIX 



could be written 



or 



or 



TIX 
ETC 



TIX 
ETC 
ETC 
ETC 



TIX 
ETC 



NAME -I- 1,4,1 



NAME -1-1 
,4,1 



NAME 

-M,4 

,1 



NAME -t- 1,4, 
1 



but could not be written 

TIX 
ETC 

The following operations may not be followed by an 
ETC card: 



NA 

ME -1-1,4,1 



ABS 

BCI 

DEC 

DETAIL 

DUP 

EJECT 

END 

ENDM 

ENDQ 

EVEN 

FUL 

IFF 



IFT 

INDEX 

LABEL 

LBL 

LDIR 

LIST 

LORG 

NOCKS 

NULL 

OCT 

OPD 

OPSYN 



ORGCRS 

PCC 

PCG 

PMC 

PUNCH 

QUAL 

REM 

TITLE 

TTL 

UNLIST 

UNPNCH 

USE 



If an ETC follows any of these operations except end, 
the ETC will be ignored and a low-severity warning 
message issued. 

The REM Pseudo-Operation 

The REM ( Remarks ) pseudo-operation permits remarks 
to be entered into the assembly listing. The format of 
the REM pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Any informa- 
tion 


REM 


Any information 



The contents of columns 8-10 (the operation field) 
are replaced by blanks, and the remaining contents of 
the card are copied onto the assembly listing. The rem 
pseudo-operation supplements the remarks card that 
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has * in column 1. In a macro-definition, the variable 
field of the kem card is scanned for substitutable pa- 
rameters, whereas the * card causes an error message 
but is otherwise completely ignored. 

The KEEP Pseudo-Operation 

The KEEP pseudo-operation permits the programmer 
to specify a debugging dictionary that contains only 
those symbols he wishes to use in debug requests. The 
format of the keep pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


KEEP 


One or more symbols ( which 
may not be qualified ) , 
separated by commas 



The symbols in the variable field are entered into 
the debugging dictionary along with any modal and 
dimensional information that was supplied in bss, bes, 
EQU, and SYN pseudo-operations. Any number of keep 
pseudo-operations may appear in a program. If the 
NODD option was specified on the $ibmap card, the keep 
pseudo-operation is ignored. ( For further information 
concerning debugging and the debugging dictionary, 
see the publications IBM 7090/7094 IBSYS Operating 
System. IBJOB Processor, Form C28-6389, and IBM 
7090/7094 IBSYS Operating System: IBJOB Processor 
Debugging Package, Form C28-6393. ) 



Absolute-Assembly Pseudo-Operations 

The pseudo operations abs, ful, punch, unpnch, and 
TCD are effective in absolute assemblies only. They are 
ignored in a relocatable assembly. 



The ABS Pseudo-Operation 

The ABS (Absolute) pseudo-operation specifies card 
output in the; standard 22-word-per-card column-binary 
card format. The format of the abs pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ABS 


Ignored 



Binary cards are normally punched in the abs mode 
unless otherwise specified. The abs pseudo-operation 
always causes the next output word to start a new card. 
Any words remaining in the punch buffer are written 
out in the previously specified format. 

Column-binary card format is described in the pub- 
lication IBM 7090/7094 IBSYS Operating System: 
IBJOB Processor, Form C28-6389. 



The FUL Pseudo-Operation 

The FUL pseudo-operation specifies card output in the 
24-word-per-card "full" mode. The format of the ful 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


FUL 


Ignored 



The ful pseudo-operation always causes the next 
output word to start a new card. Any words remaining 
in the punch buffer are written out in the previously 
specified format. Cards produced in the column binary 
full mode contain the first word of output in columns 
1-3; the second, in 4-6; and so on to a maximum of 
24 words per card. No control words or check sums 
are generated by the assembler in full mode. 

The PUNCH and UNPNCH Pseudo-Operations 

The PUNCH and unpnch pseudo-operations cause re- 
sumption and suspension, respectively, of binary card 
punching. The format of the punch and unpnch 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PUNCH or 
UNPNCH 


Ignored 



The TCD Pseudo-Operation 

A binary transfer card directs an absolute loader pro- 
gram to stop loading cards and to transfer control to a 
designated location. In most cases, a transfer card is 
required at the end of the binary deck. In absolute 
assemblies, the end pseudo-operation causes a binary 
transfer card to be punched. However, the tcd pseudo- 
operation can cause a transfer card to be produced 
before the end of the binary deck. 

The format of the TCD pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


TCD 


A symbolic expression 



The TCD pseudo-operation performs the following 
two functions : 

1. Any binary output waiting in the punch buffer is 
written out. 

2. A binary transfer card is produced having a trans- 
fer address that is the value of the expression irt the 
variable field. See the pubhcation IBM 7090/7094 
IBSYS Operating System: IBJOB Processor, Form C28- 
6389, for a description of the format of a transfer card. 

If UNPNCH is in effect, no cards are punched. 
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List-Control Pseudo-Operations 

The PCC Pseudo-Operation 

The PCC (Print Control Cards) pseudo-operation has 
the following format: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


Blanks 


PCC 


Either: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



Unless the unlist pseudo-operation is in effect, pcc 
ON causes the listing of the following cards : ttl, title, 

LBL, LIST, INDEX, SPACE, EJECT, DETAIL, PCG, PMC, IFT, 

IFF, and GOTO, and any cards under the scope of the ift, 
IFF, and goto pseudo-operations that are not assem- 
bled. PCC OFF suppresses listing of these cards and is the 
normal mode. The pcc card is always listed unless 
UNLIST is in effect. If the variable field is blank or 
contains anything other than on or off, the current 
setting of the pcc switch is inverted. 

The UNLIST Pseudo-Operation 

The UNLIST pseudo-operation causes all listing to be 
suspended. The format of the unlist pseudo-operation 
is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


UNLIST 


Ignored 



The UNLIST pseudo-operation is itself listed unless 
a previous unlist is still in effect. After an unlist, no 
lines are listed by the assembly program until a list 
or END pseudo-operation is encountered. 

The LIST Pseudo-Operation 

The list pseudo-operation causes hsting to be re- 
sumed following an unlist. The format of the list 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


LIST 


Ignored 



The list pseudo-operation does not appear in the 
assembly listing unless the mode of pcc is on. 

The TITLE Pseudo-Operation 

The TITLE pseudo-operation abbreviates the assembly 
listing by eliminating certain kinds of information. The 
format of the title pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


TITLE 


Ignored 



TITLE causes the assembly program to exclude the 
following information from the listing: 

1. Any line that contains octal information except 
the instruction that causes it, i.e., all but the first word 
generated by oct, dec, bci, and vfd 

2. All but the entire first iteration of each instruc 
tion in the range of a dup 

3. All complex fields in a relocatable assembly 

4. The expansion of save and all but the first three 
instructions in the expansion of call. 

5. All literals in the Literal Pool except the first 

A TITLE pseudo-operation is effective until the as- 
sembly program encounters a detail operation, title 
is not listed except when the mode of pcc is on. 

The DETAIL Pseudo-Operation 

The detail pseudo-operation causes the listing of 
generated data to be resumed after it has been sus- 
pended by a title pseudo-operation. The format of 
the detail pseudo-operation is : 



NAME FIELD 



Blanks 



OPERATION 
FIELD 



DETAIL 



VARIABLE FIELD 



Ignored 



The sole effect of the detail operation is to cancel 
the effect of a previous title pseudo-operation. If 
TITLE is not in effect, the detail operation is ignored 
by the assembly program. The detail operation does 
not appear in the assembly listing unless the mode of 
PCC is ON. 

The EJECT Pseudo-Operation 

The EJECT pseudo-operation causes the next line of the 
listing to appear at the top of a new page. The format 
of the EJECT pseudo-operation is : 



NAME FIELD 



Blanks 



OPERATION 
FIELD 



EJECT 



VARIABLE FIELD 



Ignored 



The EJECT pseudo-operation appears in the assembly 
listing only if the mode of PCC is on. 

The SPACE Pseudo-Operation 

The SPACE pseudo-operation permits one or more 
blank lines to be inserted in the assembly listing. The 
format of the space pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


SPACE 


1. A symbolic expression, or 

2. Blanks 



The definition of the expression in the variable field 
determines the number of blank lines in the assembly 
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listing. If the value of the expression is zero or the 
variable field is blank, one blank line appears, space 
itself is listed only if the mode of pcc is on. 

The LBL Pseudo-Operation 

Serialization of a deck normally begins with the first 
four characters of the deck name, which are left- 
justified and filled with trailing zeros. However, 
seriaHzation can be altered by using the lbl pseudo- 
operation. The format of the lbl (Label) pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


LBL 


One or two subfields, separated 
by a comma: 

1. Up to 8 BCD characters, 
which may or may not be 
followed by a comma if the 
second subfield is not present 

2. The word BEGIN followed 
by a blank or a comma 



LBL causes binary cards to be identified and serialized 
in columns 73-80, as follows: 

1. Serialization begins with the characters appear- 
ing in the variable field, which is left-justified and 
filled with terminating zeros. 

2. Serialization is incremented by one for each 
card until the rightmost nonnumeric character or the 
seventh character is reached, after which the numeric 
portion recycles to zero. The two leftmost characters 
are regarded as fixed, even though they may be 
numeric, 

For example, if the variable field is coded as id, the 
first card is identified and serialized as idoooooo. 

If the variable field is coded as instr03, serialization 

is as follows : 

INSTR030 
INSTR031 



INSTR999 
INSTROOO 



If the BEGIN option is not included, reserialization 
be;gins with the binary card following the one that is 
currently being punched. Serialization can be altered 
at any point in the program by using additional lbl 
pseudo-operations. 

If the BEGIN option is included, the lbl will be effec- 
tive from the beginning of the program, serializing all 
binary cards, including the $file and slabel cards 
created by ibmap as a result of the corresponding 
pseudo-operations, no matter where the lbl appears 
in the program. If more than one lbl pseudo-operation 
with the begin option is used, only the last one will be 



effective. Any lbl pseudo-operations that do not con- 
tain the begin option are processed normally. 

If the variable field of the lbl currently in effect 
does not end with a comma, the assembly program 
prints the phrase 



BINARY 



CARD 



ID. Number 



at the beginning of each card. If a comma is used to 
terminate the variable field, printing of this phrase is 
suppressed. Printing of this phrase can be reinitiated 
by using an lbl pseudo-operation ending in a blank. 
] BL is listed only if the mode of pcc is on. 



The INDEX Pseudo-Operation 

The INDEX pseudo-operation provides a table of con- 
tents of important locations within an assembly. The 
format of the index pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


INDEX 


Symbols, separated by commas 



The first appearance of an index card causes the 
message 

TABLE OF CONTENTS 
to be listed. Each subfield of an index pseudo-opera- 
tion causes the symbol and its definition to be listed. 
If a virtual symbol is used, its definition will be the 
control section number assigned to the symbol. 

index pseudo-operations may appear anywhere in 
the source program and need not be grouped. The 
listing generated by index pseudo-operations is in- 
serted where the pseudo-operations appear. 

For meaningful commentary, index pseudo-oper- 
ations can be grouped and interspersed with ex- 
planatory remarks cards. 

An INDEX pseudo-operation is not processed if: any 
of the following three conditions exist: 

1. It is in a macro-expansion and pmc is off, 

2. It is in the range of a dup pseudo-operation and a 
TITLE pseudo-operation is in effect. 

3. An UNLIST pseudo-operation is in effect. 
Listing of the index card itself is governed by the 

mode of the pcc switch. 

The variable field of an index pseudo-operation 
cannot be extended by use of the etc pseudo-operation. 

The PMC Pseudo-Operation 

The PMC pseudo-operation causes (or suppresses) fist- 
ing of the card images generated by macro-instructions 
and by the return pseudo-operation. The format of 
the PMC (Print Macro Cards) pseudo-operation is: 
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OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


Blanks 


PMC 


Any one of: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



ON in the variable field causes listing of the card 
images generated by macro-instructions; off, which is 
the normal mode, suppresses such listing. A blank 
variable field or one containing any information other 
than ON or off inverts the current setting of the pmc 
switch. 

ETC cards extending the variable field of a macro- 
instruction are listed even if the mode of pmc is off. 

Listing of the pmc card is controlled by the pcc 
pseudo-operation. 

The TTL Pseudo-Operation 

The TTL (Subtitle) pseudo-operation generates a sub- 
heading in the listing. The format of the ttl pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


TTL 


A string of BCD characters 
starting in card column 12 



Card columns 13-72 are used in words 4-13 of a 
generated subheading, which will appear on each 
page. TTL also forces a page ejection. 

A subheading may be replaced by the variable field 
of another ttl and may be deleted by a ttl with a 
blank variable field. 

Listing of the ttl card is controlled by the pcc 
pseudo-operation. 

The PCG Pseudo-Operation 

The PCG (Print Control Group) pseudo-operation 
causes listing of the relocatable control bits of each 
assembled word. The format of the pcg pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PCG 


Any one of: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



ON in the variable field causes listing and off sup- 
presses listing of the relocatable control bits for each 
assembled word, on is the normal mode. A blank 
variable field or one containing any information other 
than ON or off inverts the current setting of the pcg 
switch. PCG is ignored in an absolute assembly. 

PCG is listed if the mode of pcc is on. 



Special Systems Pseudo-Operations 

Users of the map language are provided with a wide 
range of subroutines which are included in the sys- 
tems library. A group of system pseudo-operations 
permits the transfer of control and data between the 
main program and the subroutine. Details about 
specific calling sequences are provided in the publica 
tions IBM 7090/7094 IBYSY Operating System: IBJOB 
Processor, Form C28-6389 and IBM 7090/7094 Opera 
ting System: Input/Output Control System, Form 
C28-6345. 

The CALL Pseudo-Operation 

The call pseudo-operation produces the standard 
IBJOB subroutine calling sequence. The format of the 
call pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


CALL 


One or more subfields: 

1. Symbol or** 

2. Calling sequence param- 
eters 

3. Error returns 

4. Identification number 



The first subfield in the variable field must contain 
an unqualified symbol (the name of a subroutine) or 
**. The next subfield contains the parameters of the 
calling sequence ( if any ) , enclosed in parentheses and 
separated by commas. These may be any symbolic ex 
pression. 

Error returns ( if any ) , separated by commas, occupy 
the next subfield. The last subfield is an identification 
number (if desired), less than 32,768 and delimited by 
apostrophes. If specified, this number appears in the 
calling sequence in place of the assembly line number. 
When an identification number is not specified, the 
assembly line number appears. 

For example, a typical call operation might be 
coded 



LCS 



CALL 

ETC 



name(argl,arg2, . . . ,argn) 
retl,ret2, . . . ,retn'id' 

where name is the name of a subroutine; argl, arg2, 
. . . , argn are the parameters of the calling sequence; 
retl, ret2, . . . , retn are the error returns; and 'id' is the 
identification number. 

A comma should not precede the left parenthesis, 
follow the right parenthesis, nor precede the 'id'. 

If the subroutine is part of the program being assem- 
bled, the reference is to the routine in the program. 
However, if the subroutine is not part of the program 
being assembled, the symbol in the first subfield of the 
variable field becomes the external name of the sub- 
routine called. If ** is used, a constant zero becomes 
the called address. 



MAP Pseudo-Operations 37 



The remaining subfields generate the calHng se- 
quence. 

Expansions of fhe CALL Pseudo-Opemtion 

The linkage produced by 



LCS 



IS 



L,CS 



CALL 
ETC 

TSX 
TXI 
PZE 
PZE 



PZE 
TRA 



TRA 



NAME (PI, 
Rm'ID' 



. ,Pn)Rl, 



NAME,4 

* + 2+n+m„n 

ID„Linkage Director 

PI 



Pn 
Rm 



Rl 



where P is a subroutine parameter, R is an error 
return, n is the number of parameters and m is the 
number of error returns. The Linkage Director is a 
location unique for each assembly, and has no associ- 
ated symbol. It may be given a symbolic designation 
using the ldir pseudo-operation. 
The operation 



LCS 

produces 

LCS 



CALL 

TSX 
TXI 
PZE 
PZE 
PZE 

The statement 

LCS CALL 

produces 

LCS TSX 

TXI 
PZE 
TRA 

The statement 
LCS CALL 



generates 
LCS 



TSX 
TXI 
PZE 



NAME(PLP2: 



NAME,4 

*-l-2-l-2-l-0„2 

Line number„Llnkage Director 

PI 

P2 



NAME.Rl 



NAME,4 

*-l-2 + + l„0 

Line number,, Linkage Director 

Rl 



NAME 



NAME,4 

* + 2-1-0 -f-0,,0 

Line number„Linkage Director 



The SAVE Pseudo-Opemtlon 

The SAVE pseudo-operation produces the instructions 
necessary to save and restore the index registers and 
indicators, to disable and restore all operative traps, 
to provide error returns used by a subprogram, and 
to store the contents of index register 4 in sysloc and 



in the Linkage Director. The format of the save 
pseudo-operation is: 



NAME FIELD 



Symbol 



OPERATION 
FIELD 



SAVE 



VARIABLE FIELD 



Up to 7 subfields containing 
integers or immediate sym- 
bols and any or all of the 
letters I, D, E 



The order in which the subfields in the variable field 
of the SAVE pseudo-operation are used is not important. 
All subfields are optional. 

As many as 7 numeric subfields may be used to 
specify the index registers that are to be saved and 
restored. Immediate symbols may also be used to 
specify index registers. Any or all index registers may 
be specified in any order. 

Index registers are saved in the order 4, 1, 2, 3, 5, 
6, 7 and are restored in the opposite order. Index reg- 
ister 4 is automatically saved and restored, although 
it may still be specified. 

One of the three remaining subfields is literally the 
character I; another is literally the character D; and 
the last is literally the character E. 

The presence of I signifies that the sense indicators 
are to be saved and restored. 

The presence of D causes all operative traps to be 
disabled and restored. 

The presence of E generates the instructions neces- 
sary to facilitate use of error returns in the call 
pseudo-operation. 

The contents of index register 4 are stored in the 
Linkage Director each time the save pseudo-operation 
is executed, sysloc is a standard communication loca- 
tion used by all programs loaded under ibldr. If the 
assembly is absolute (the absmod option is specified), 
the symbol sysloc must be defined by the programmer. 

The general form of the save pseudo-operation is: 

locsym SAVE (Xi, . . . ,Xk)I,D,E 



or 



locsym 



SAVE 



Xi, . . . ,Xk,I,D,E 



Expansions of the SAVE Pseudo-Operation 

The instruction 

LCS SAVE 2,1,1 

or its equivalent 

LCS SAVE (2,1)1 

specifies that index registers 2 and 1 and the sense 
indicators are to be saved. 
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The expansion is: 



ENTRY 



LCS 



LCS 


TXI 
AXT 
AXT 


. .0003„0 
**2 
** 2 


. .0001 


AXT 


** 4 


1 


LDI 


..0002 + 1 


. .0002 


TRA 
PZE 


1,4 


1 . .0003 


STI 

SXA 
SXA 
SXA 
SXA 
SXA 


..0002 + 1 
SYSLOC,4 
Linkage Director,4 
. .0001,4 
..0001-1,1 
..0001-2,2 


The instruction 






LCS 


SAVE 


2 


generates 








ENTRY 


LCS 


LCS 


TXI 
AXT 


. .0003„0 

**,2 


. .0001 


AXT 


** 4 


. .0002 


TRA 


1,4 


. .0003 


SXA 
SXA 
SXA 

SXA 


SYSLOC,4 
Linkage Director,4 
. .0001,4 
..0001-1,2 



In the next two examples, the instructions generated 
because of using the letters I, D, or E in the subfield 
of a SAVE pseudo-operation are identified by the ap- 
pearance of the particular letter in the comments field 
of the generated instruction. 

The instruction 



LCS 


SAVE 


2,I,D 




generates 










ENTRY 


LCS 




LCS 


TXI 

AXT 


. .0003„0 

**,2 




. .0001 


AXT 


**,4 






LDI 
NZT 
ENB* 


..0002 + 1 

.TRPSW 

.TRAPX 


I 

D 

D 


. .0002 


TRA 
PZE 


1,4 


I 


. .0003 


XEC 
STI 
SXA 
SXA 

SXA 
SXA 


SYSDSB 
..0002 + 1 
SYSLOC,4 
Linkage Din 
. .0001,4 
..0001-1.2 


D 
I 

jctor 



Locations sysdbs, .trpsw, and .trapx are in the Sys- 
tem Monitor (see the publication IBSYS Operating 
System: System Monitor (IBSYS), Form C28-6248). 
A switch at .trpsw indicates whether enabling is per- 
missible at this time; .trapx gives the address of the 
location that contains the bits for proper enabling. 
(Note that the enabling instruction below refers to 
.trapx indirectly. ) 



The following sequence illustrates the expansion 
that is generated when the E option is specified: 

LCS SAVE (2)I,D,E 

generates 



LCS 



.0001 

.0002 
.0003 



ENTRY 

TXI 

LDC 

SXD 

LAC 

TXI 

SXA 

LXA 

TXI 

SXA 

AXT 

AXT 

LDI 

NZT 

ENB* 

TRA 

PZE 

XEC 

STI 

SXD 

SXA 

SXA 

SXA 

SXA 



LCS 

. .0003,,** 
LCS,4 

* + 5,4 

. .0001,4 

* + 1,4,1 

* + l,4 
*♦ 4 

*-hl,4,** 
. .0002,4 
**,2 
«* 4 

..0002 + 1 

.TRPSW 

.TRAPX 



E 
E 
E 
E 
E 
E 
E 
E 



I 

D 

D 

E 

I 

D 

I 

E 



SYSDSB 
..0002 + 1 
LCS,0 
SYSLOC,4 
Linkage Director,4 
. .0001,4 
..0001-1,2 



If the SAVE pseudo-operation has no symbol in the 
name field, a symbol will be generated and an error 
message will be printed. 

The SAVEN Pseudo-Operation 

The SAVEN pseudo-operation produces the instructions 
necessary to save and restore the index registers used 
by a subprogram. The format of the saven pseudo- 
operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


SAVEN 


Up to 10 subfields 



The SAVEN pseudo-operation is similar to save except 
that the instructions 

ENTRY LCS 

SXA Linkage Director,4 

are not generated, saven is generally used when en- 
tering a subroutine from another subroutine without 
destroying the linkage information. If the saven 
pseudo-operation has no symbol in the name field, a 
symbol will be generated and an error message will 
be printed. If the variable field is blank, index register 
4 is saved and restored. 

The RETURN Pseudo-Operation 

The return pseudo-operation is designed for use with 
CALL and SAVE, making use of the error ( or alternate ) 
returns used in these operations. 
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The format of the return pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


RETURN 


1 or 2 subfields separated by 
a comma: 

1. A symbol, 

2. An integer, a symbol, or 
an immediate symbol 



The first subfield in the variable field of the return 
pseudo-operation is required. It contains the name 
of the associated save pseudo-operation. If the second 
subfield is present, it specifies the particular error 
return. 

The RETURN pseudo-operation often takes the general 

form 

name RETURN locsym,i 

where locsym is the symbolic address of the associated 
SAVE pseudo-operation, and i is the desired error 
return ( i = is the normal return ) . 

The form of the return instruction may vary. For 
example;, to specify a particular error return (e.g., 2), 
the instruction 



LOG RETURN LCS,2 

is written, where lcs is the location of the save pseudo- 
operation to be used. The following instructions are 
generated: 

LOG 



AXT 
SXD 
TRA 



2,4 
LGS,4 
LCS -1-1 



If the E option of the save or saven pseudo-operation 
is not used, the following form should be used: 

RETURN LGS 
which generates 

TRA LGS-f-1 

This form should also be used even where the E option 
is specified if the error return is inserted into the dec- 
rement of the save or saven pseudo-operation at 
execution time. 

The variable field of the return pseudo-operation 
may not be left blank, since it results in a tra instruc- 
tion with a blank variable field. The pmc pseudo- 
operation governs the listing of the instructions 
generated by the return pseudo-operation. 
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Part III. The Macro-Operation Facility 



Macro-operations are special types of pseudo-opera- 
tions that provide the map user with a powerful pro- 
gramming tool. After a programmer has defined a 
macro-operation, he can cause a whole sequence of 
instructions to be called into a program by coding a 
single instruction. The sequence can be repeated as 
often as desired. Moreover, any field or subfield of 
any instruction in the sequence can be changed each 
time the sequence is repeated. 

Any machine instruction, pseudo-operation, or 
macro-operation can be included in a macro-oper- 
ation. The sequence of instructions generated ( usually 
called a macro-expansion) is an open subroutine. The 
instructions are executed in-Hne with the rest of the 
program. 

Two general requirements must be met to take 
advantage of the macro-operation facility. First, the 
macro-operation must be defined by a macro-defini- 
tion. Then, wherever the sequence of instuctions is 
desired in the program, it must be called by a macro- 
instruction. 



Defining Macro-Operations 

A macro-definition provides a name for the macro- 
operation, determines the instructions that will be in- 
cluded in the macro-expansion, and establishes the 
parts of the instructions that are to be variable. 

Three kinds of instructions must be coded to de- 
fine a macro-operation. The first is the macro pseudo- 
operation. (The card containing this instruction is 
sometimes called the macro-definition heading card.) 
Prototype instructions (sometimes called prototype 
card images) immediately follow the macro pseudo- 
operation to establish the instructions that will be 
generated in the macro-expansion. Finally, the endm 
pseudo-operation ends the macro-definition. 

The MACRO Pseudo-Operation 

The macro pseudo-operation establishes the name of 
a macro-operation. The format of the macro pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


BCD name up 
to 6 characters 
long 


MACRO 


Up to 63 substitutable argu- 
ments (groups of not more 
than 6 characters) separated 
by punctuation characters 



The name in the name field becomes the name of 
the macro-operation that is being defined. This name 
is later used to call the macro-operation and thus, in 
effect, becomes an operation code. Any vaHd symbol 
may be used in the name field of the macro pseudo- 
operation, or all numeric characters may be used. 
However, six zeros may not be used. 

The name in the name field of a macro pseudo- 
operation may be the same as a symbol used any- 
where in the program, even in this or any other macro- 
operation. However, if this name is the same as any 
other machine operation code, pseudo-operation codt^ 
or macro-operation code, the operation code is m- 
defined. 

The subfields in the variable field of the macro 
pseudo-operation contain substitutable arguments. 

SUBSTITUTABLE ARGUMENTS IN THE MACRO 
PSEUDO-OPERATION 

Much of the flexibility of the macro-operation facility 
results from the principle of substitutable arguments. 
These subfields in the variable field of the macho 
pseudo-operation are dummy names that will be re- 
placed in the macro-expansion. 

Substitutable arguments permit any field or subfield 
of any instruction to be changed each time the macro- 
operation is called. The programmer can also change 
parts of subfields and even add entire instructions. 

A substitutable argument is from one to six char- 
acters long. Any valid symbol may be used, and the 
name of a substitutable argument may consist of all 
numeric characters. For example, in the macro 
pseudo-operation 



ALPHA 



MACRO ABC, 123 



each of the two groups of three characters in th<> 
variable field is a substitutable argument. 

No punctuation characters except the period may be- 
used as part of a substitutable argument. 

A substitutable argument may be the same as a 
symbol or an operation code, including the operation 
code for this or any other macro-operation. However, 
substitutable arguments should not be identical to 
symbols or operation codes used in the prototype that 
immediately follows unless the symbols or operation 
codes are actually intended to be substitutable argu- 
ments. 



The Macro-Operation Facility 41 



DELIMITI]^JG SUBSTITUTABLE ARGUMENTS IN THE MACRO 
PSEirDO-OPERATION 

Substitutable arguments in the variable field of the 
MACRO pseudo-operation may be separated by any of 
the following punctuation (special) characters: 

= + -*/(),' 
If parentheses are used, they must be used in pairs. 

The use of these characters permits meaningful 
notation in a macro-definition. For example, 

ALPHA MACRO 23,RATE,TIME,DIST, 

QUSYM 

could also be written 

ALPHA MACRO 23(RATE*TIME = DIST) 

QUSYM 

The variable field of the macro pseudo-operation 
may be (extended over more than one card by using the 
ETC pseudo-operation. When the substitutable argu- 
ments appear on more than one card, the blank char- 
acter acts as a separator. Hence, no punctuation char- 
acter is needed between consecutive substitutable 
arguments that appear on separate cards. For example, 

BETA MACRO A,B,C 

could also be written 



BETA 



MACRO A,B 
ETC C 



This usage of the etc pseudo-operation differs from 
the usual case, in which all punctuation characters 
must be written. 

Consecutive punctuation characters or an explicit 
zcjro are ignored and do not result in a substitutable 
argument of zero. 

Profotypes in Macro-Definitions 

The prototype of a macro-definition determines the 
instructions that will be included in the macro-expan- 
sion, their sequence in the expansion, and the positions 
of the substitutable portions of the instructions. The 
prototype, which consists of one or more prototype 
instructions, immediately follows the macro pseudo- 
operation. 

A prototype instruction is similar to any other in- 
struction. It has a name field, an operation field, and 
a variable field. It may also have a comments field, 
although this field does not appear in the card image 
generated in the macro-expansion. The distinguishing 
feature of a prototype instruction is that parts of it can 
be made variable. 

The fields or subfields of a prototype instruction may 
contain text or substitutable arguments. 

TEXT IN PROTOTYPES 

Text represents the fixed parts of the instructions that 
will be generated in the macro-expansion. Any part of 



a prototype instruction that has not been made a sub- 
stitutable argument by its appearance in the variable 
field of the macro pseudo-operation is treated as text. 
For example, in the prototype 



ALPHA MACRO A,B 

CLA A 

B BUFFER 



the operation code cla and the location buffer are 
text. ( BUFFER has been defined elsewhere in the 
program.) 

Text is reproduced in the macro-expansion exactly 
as it appears in the prototype instruction. Thus, if only 
text is used in a field of an instruction, it must con- 
form to the rules governing that field of the instruc- 
tion in which it is used. For example, if the oper- 
ation field of a prototype instruction is text, it must 
be a valid operation code. 

Since parentheses can be used to delimit substi- 
tutable arguments within the prototype, parentheses 
must be used carefully as part of text to avoid con- 
fusing the enclosed characters with a substitut^le 
argument. 

SUBSTITUTABLE ARGUMENTS IN PROTOTYPES 

Substitutable arguments represent the variable parts 
of the instructions that will be generated in the macro- 
expansion. The same substitutable arguments are used 
in the prototype that appeared in the variable field of 
the MACRO pseudo-operation. However, in the proto- 
type, substitutable arguments appear in the fields or 
subfields of the prototype instructions that are to be 
variable. A substitutable argument may appear in any 
field or subfield of a prototype instruction. For ex- 
ample, in the sequence. 



BETA 
ONE 



MACRO ONE,TWO,THREE 

CLA PARTI 

TWO PART2 

STO THREE 



ONE, TWO, and three are substitutable arguments in 
the name, operation, and variable fields, respectively, 
of prototype instructions. 

DELIMITING SUBSTITUTABLE ARGUMENTS IN PROTOTYPES 

The same punctuation (special) characters may be 
used in prototype instructions that were used to sep- 
arate the substitutable arguments in the variable field 
of the MACRO pseudo-operation. Except for the apos- 
trophe, these characters are reproduced in the macro- 
expansion. Only the aspostrophe may be used to delimit 
substitutable arguments in the variable fields of rem 
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and TTL pseudo-operations and the data subfields of bci 
pseudo-operations. (Another use of the apostrophe in 
macro-operations is explained in the section "Com- 
bining Substitutable Arguments and Text.") 

A comma or a left parenthesis immediately follow- 
ing the operation code (as near the beginning of the 
card as column 11) signifies the end of the operation 
field and the beginning of the variable field. 

A blank delimits a substitutable argument in a pro- 
totype. For example, in the macro-definition (where 
b represents a blank) 



XYZ 



MACRO 
AbbbB 



A,B,C 



three blanks separate A (in the operation field) from 
B (in the variable field). It is not always necessary 
that three blanks separate these two fields, but at 
least three characters are used for an operation field 
code. In this example, A and two blanks are used, 
whereas the third blank is required to terminate the 
operation field. If fewer blanks separated A from B, 
both would be taken as part of the operation code, 
causing errors. 

If a blank is encountered before card column 72 
in the variable field of a prototype instruction other than 
a BCI, REM, or TTL pscudo-operation, the card is termi- 
nated. Substitutable arguments may appear anywhere 
from column 1 through column 72 on bci, rem, and 
TTL cards. Any information to the right of the blank will 
not be included in the macro-definition. 

If a BCI, TTL, or REM pscudo-opcration has been re- 
defined in a macro-definition or by an operation- 
defining pseudo-operation, it should not be used within 
a macro-definition. Also, if an operation code has been 
defined to have the effect of a bci, ttl, or rem pseudo- 
operation and is used within a macro-definition, the 
variable field will be terminated by a blank. 

Every field or subfield of six or fewer characters in 
any field of a prototype instruction is compared with 
the substitutable arguments in the variable field of 
the MACRO pseudo-operation. Therefore, care must be 
taken to avoid confusing fields intended as text with 
fields intended as substitutable arguments. 

Cards with an asterisk (*) in column 1 (remarks 
cards ) may be interspersed with macro-definition cards 
but will not be included in the macro-expansion. 

The ENDM Pseudo-Operation 

The ENDM pseudo-operation terminates a macro- 
definition. The format of the endm pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ENDM 


Either: 

1. One or two subfields, sep- 
arated by a comma, or 

2. Blanks 



The ENDM pseudo-operation immediately follows the 
last prototype instruction and ends the macro-defini- 
tion. An ENDM pseudo-operation is required for every 
MACRO pseudo-operation. 

The first of the two subfields permitted in the 
variable field of the endm pseudo-operation is a bcd 
name of up to six characters. If a name is used in this 
subfield, it must be the same as the name used for the 
corresponding macro pseudo-operation. If the first 
subfield is not used, but the second is, a comma must 
precede the second subfield. 

If the second subfield in the variable field of the 
ENDM pseudo-operation is present, it specifies either 
crs (create symbols) or nocrs (no created symbols). 
The second subfield controls symbol creation for this 
macro-operation only, overriding the effect of the 
nocrs and orgcrs pseudo-operations (see the section 
"Created Symbols"), crs in this subfield always causes 
and nocrs always suppresses symbol creation each 
time the macro-operation is called. Any symbol other 
than CRS or nocrs has no effect. 

For example, in the macro-definition 



ALPHA 



MACRO 

CLA 

ADD 

STO 

ENDM 



A,B 

A 

B 

SUM 

ALPHA.NOCRS 



the ENDM pseudo-operation is coded so that symbol 
creation is suppressed whenever this macro-operation 
is called. 

If the variable field or the first subfield of the 
variable field is blank, this and all unterminated macro- 
definitions are terminated (see the section "Nested 
Macro-Operations" ) . 



Calling Macro-Operations 

After a macro-operation has been defined, it may be 
called so that the generated sequence of instructions 
is brought into a program at a desired point. In the 
macro-expansion, each prototype instruction in the 
macro-definition is reproduced. Text and all punctua- 
tion characters except the apostrophe are reproduced 
exactly as they appeared in the prototype. However, 
the substitutable arguments thiat appeared in the varia- 
ble field of the macro pseudo-operation and in the 
prototype are replaced by the actual parameters that 
the programmer wishes to appear in the expansion. 
These parameters are provided in the macro-instruc- 
tion, which is used to call the macro-operation. 

The Macro-lnstrucMon 

The macro-instruction calls a previously defined 
macro-operation into a program. The format of the 
macro-instruction is : 
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NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


Macro- 
operation 
name 


Parameters, separated by com- 
mas or enclosed in parentheses. 



If there is a symbol in the name field, it is assigned to 
the first instruction of the macro-expansion. 

The name that was assigned in the name field of the 
MACRO pseudo-operation is an operation code and is 
used in the operation field of the macro-instruction. 

The variable field of the macro-instruction contains 
the actual parameters that the programmer wishes to 
appear in the macro-expansion. 

PARAMETERS IN MACRO-INSTRUCTIONS 

The parameters in the variable field of the macro- 
instruction replace the substitutable arguments that 
appeared in the macro-definition. These parameters 
must appear in the same order as the substitutable 
arguments they are to replace originally appeared in 
the variable field of the macro pseudo-operation. 

The length of a parameter in the variable field of a 
macro-instruction is not limited to six characters as is a 
substitutable argument. The variable field of a macro- 
instruction may be extended over more than one card 
by using the etc pseudo-operation. However, a single 
parameter must appear completely on one card unless 
it is enclosed in parentheses. 

Macro-instruction parameters consist of any appro- 
]5riate character or group of characters that would 
normally appear in the particular instruction. For ex- 
ample, in the macro-definition. 

QPOLY 
LOOP 



MACRO 


COEFF,LOOP,DEG,T,OP 


AXT 


DEG.T 


LDQ 


COEFF 


FMP 


GAMMA 


OP 


COEFF -1-DEG-I-1,T 


XCA 




TIX 


LOOP,T,l 


ENDM 


QPOLY 



mnemonic symbols represent the substitutable argu- 
ments. LOOP appears in a name field, op in an operation 
field, and coeff, dec, and T appear in subfields of the 
variable field, gamma is text and not a substitutable 
argument, since it does not appear in the variable field 
of the macro pseudo-operation. In this macro-instruc- 
tion, a symbol should be substituted for loop and a 
valid operation code for op. Such a macro-instruction 
might be written 



XOI5: 



QPOLY CI - 4,FIRST,5,4,FAD 



The macro-expansion would cause the following 
six card images to be generated. 



FIRST FMP GAMMA 

FAD Cl-4-1-5+1,4 

XCA 

TIX FIRST,4,1 

The symbol xois is assigned to the first instruction, 
and each substitutable argument is replaced by the 
corresponding parameter that appeared in the variable 
field of the macro-instruction. 

delimiting macro-instruction parameters 

The parameters in the variable field of a macro- 
instruction are separated either by commas or paren- 
theses. A single comma following a right parenthesis 
or preceding a left parenthesis is redundant and may 
be omitted. Neither of these combinations results in a 
null parameter. A null parameter is indicated by two 
consecutive commas or by a single comma at the be- 
ginning of the variable field. If the blank terminating 
the variable field is preceded by a comma, the last 
subfield is not null (see the example in the section 
"Created Symbols"). An expHcit zero must be used to 
obtain a zero parameter. 

Parentheses around data used as a macro-instruction 
parameter signify that everything within the paren- 
theses, including blanks, is to replace the correspond- 
ing substitutable argument in the prototype. ( In fact, 
if blanks are to be included in a macro-instruction 
parameter, the parameter must be enclosed in paren- 
theses. ) For example, the macro-definition 



XYZ 
B 



MACRO 

A 

ENDM 



A,B 



XYZ 



followed by the macro-instruction 



XYZ 

ETC 

results in the expansion 



ALPHA 



AXT 
TRA 



(AXTbbbbblO,!) 

( ALPHAbbTRAbbbbbBETA,l) 



10,1 
BETA,1 



X015 



AXT 
LDQ 



5,4 
Cl-4 



If parentheses are to appear in a macro-expansion, 
they must be enclosed in an outer pair of parentheses. 
The outer parentheses are removed in the expansion. 

Pairs of parentheses must be balanced. For example, 
given the macro-definition 

GALLIC MACRO IOCOM,Tl,OP,LABEL,T2 

ETC TAPNO,PFX,ERRET 

TSX (TAPE), 4 

PZE IOCOM,Tl,OP 

PZE LABEL,T2,TAPNO 

IFT ERRET=1 

PFX ERRET 

ENDM GALLIC 

and using the following parameters in place of the 
substitutable arguments 
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lOCOM - CITIO 

Tl-2 

OP-(RBEP) 
LABEL - CITLB 



T2 - null 

TAPNO - CITTAP 
PFX - null 
ERRET - null 



the corresponding macro-instruction would be 

GALLIC CITIO,2, ( ( RBEP ) ) ,CITLB 
ETG ,CITTAP„, 

This macro-instruction could also be written 

GALLIC GITIC,2 ( ( RBEP ) ) GITLB 
ETG ,GITTAP,„ 

since the commas around ( ( rbep ) ) are redundant. 
Note that tape must not be a substitutable argument 
and that (rbep) must be enclosed in outer parentheses. 
Also, an explicitly null parameter appears in the macro- 
instruction at a position corresponding to the substi- 
tutable argument erret in the macro-definition. This 
null parameter causes the fifth word of the expansion 
to be omitted. 

Inserting Instructions into Macro-Expansions 

A single parameter in a macro-instruction may include 
more than one field or even an entire instruction to 
replace a single substitutable argument that appeared 
in a field of a prototype instruction. The parameter is 
inserted into the field in which the original substituta- 
ble argument appeared, and it may extend to other 
fields to the right of the field in which it is inserted. 
For example, if a substitutable argument appeared in 
the operation field of a prototype instruction, a parame- 
ter could be inserted that would have an operation 
field and a variable field. 

When a parameter consists of more than one field 
or is an entire instruction, the programmer must pro- 
vide enough blanks in the parameter so that the fields 
of the instruction appear in their proper positions in 
the macro-expansion. 

In the following example, a substitutable argument 
in the operation field of a prototype instruction is re- 
placed by an instruction having an operation field and 
a variable field. The macro-definition. 



XYZ 



MAGRC A,B,G, 

CLA A 

B 

STC G 

ENDM XYZ 



followed by the macro-instruction 



SUM 



XYZ ALPHA (ADDbbbbbBETA) 

ETG GAMMA 



results in the macro-expansion 



GLA 
ADD 
STC 



ALPHA 

BETA 

GAMMA 



Conditional Assembly in Macro-Operations 

The iFT and iff pseudo-operations may be used to de- 



termine whether instructions within a macro-expansion 
are assembled. For example, the sequence 



MAGRC 


B,G,D 


GLA 


B 


ADD 


G 


IFF 


/D/=/AG/ 


STC 


D 



ADDM 



allows the sum to be stored if the name substituted for 
D is not literally the characters ac and prevents it 
from being stored if the name is the characters ac. 

If the IFF pseudo-operation in the above example 
were replaced by 



IFT 



D = l 



the sum would be stored only if the parameter substi- 
tuted had already appeared in the name field of some 
instruction (i.e., if the S-value of D is 1). 

The two conditions can be combined to obtain 



IFF 
IFT 



/D/ = /AGAAND 
D = l 



which assembles the store operation only if D is not 
literally ac and has appeared before in a name field. 

Combining Substitutable Arguments and Text 

The apostrophe can be used to combine substitutable 
arguments and text to form a single prototype subfield. 
The apostrophe delimits a substitutable argument in a 
macro-definition prototype but is not itself included in 
the macro-expansion. However, the apostrophe may not 
be used to combine partial subfields in lower-level 
nested macro-definitions (see the section "Nested 
Macro-Operations" ) . 
For example, given the macro-definition 



ALPHA 



MAGRC 
BGI 



ENDM 
the macro-instruction 



A,B,G 

A,bb'B'bERRCR,b 
GCNDITICN'G'b 
IGNCRED 
ALPHA,NCGRS 



ALPHA 6, (FIELD),, 
causes the following instruction to be generated: 

BGI 6,bbFIELDbERRCR,b 

GCNDITICNb 

IGNCRED 

By using the apostrophe, instructions within macro- 
operations can be altered and even name field symbols 
can be changed. For example, the macro-definition 

FXGY MAGRC B,W,Z,Y,T 

N'B PXA Y,T 

PAG 0,4 

'W'X'Z Y,4 

ENDM FXGY 

after the macro-instruction 

FXGY AME,S,A,DATA,1 
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results in the sequence 

NAME PXA DATA,1 

PAC 0,4 

SXA DATA,4 

The name field may not exceed six characters in the 
prototype, including substitutable arguments, text, and 
pimctuation characters. The operation field may not 
exceed six characters or six characters and an asterisk. 

Nested Macro-Operations 

A macro-definition may be included completely within 
the prototype o£ another higher-level macro-definition. 
When the higher-level macro-operation is expanded, 
the MACRO pseudo-operation and the prototype of the 
lower-level macro-operation are generated. Thus, a 
macro-instruction for a lower-level macro-operation 
cannot be used until all higher-level macro-operations 
have been expanded. 

A new macro-operation may be defined or an existing 
macro-operation redefined, depending on whether the 
name of the lower-level macro-operation appears as text 
or as a substitutable argument in the higher-level 
macro-operation. For example, in the macro-definition 

MACl MACRO MAC2,ALPHA,BETA 

ETC GAMMA,DELTA 

MAC2 MACRO ALPHA 

BETA A 

GAMMA B 

DELTA C 

ENDM MAC2 

ENDM MACl 

the lov^'er-level macro-operation, mac2, appears as a 
substitutable argument. The macro-instruction 

MACl ABC,(A,B,C),CLA,ADD,STO 



.Generates 
ABC 


MACRO 


A,B,C 




CLA 


A 




ADD 


B 




STO 


C 




ENDM 


ABC 



which defines a macro-operation, abc, where A, B, and 
C are substitutable arguments; and cla, add, and sto 
are text. 

However, had macs appeared. as text rather than as a 
substitutable argument in the macro-definition of maci, 
MACS would be redefined each time maci was ex- 
panded. 

There is no significant Hmit to the depth of nesting 
permitted. 

Macro-Instructions in Macro-Definitions 

The prototype of a macro-definition may include 
macro- instructions for which macro-operations have 
not yet been defined. However, these macro-instruc- 
tions must be defined before using a macro-instruction 



that expands the macro-operation. Care must be ex- 
ercised to avoid a macro-definition loop. For example, 
if macro-operation A contains an unconditional call 
on macro-operation A (a macro-instruction for A), a 
macro-definition loop will result. However, if the call 
on macro-operation A is conditional (i.e., there is pro- 
vision for eventual exit from the loop ) , a macro-oper- 
ation A may contain a macro-instruction for A. 

Data enclosed within parentheses may be used as a 
parameter in a macro-instruction. When a macro- 
instruction is used within another macro-defiriition, 
special handling of data containing blanks is required. 
Such data must be replaced by a substitutable argu- 
ment in the outer macro-definition. The actual data 
must appear as a parameter in the macro-instruction. 
An additional pair of parentheses must surround the 
data (already within a single pair of parentheses) to 
ensure proper substitution. 

For example, in the macro-definition 

MACl MACRO A,C 

CLA C 

MAC A,(AXTbb**,4b) 

STO A 

ENDM MACl 

MAC is a previously defined macro-operation. Proper 
substitution would not occur, because a blank termi- 
nates the variable fields of prototype instructions except 
for the BCi, rem, and ttl pseudo-operations. Instead, 
the following sequence should be used: 
MACl 



MACRO 


A,C,D 


CLA 


C 


MAC 


A,D 


STO 


A 


ENDM 


MACl 



When using the macro-instruction maci, the substitu- 
tion would be 

MACl X,Y,((AXTbb**,4b)) 

The resulting generated sequence is 



CLA 
MAC 
STO 



X,(AXTbb**,4b) 
X 



The macro-instruction for mac can now cause the data 
to be substituted properly. 

Qualification Within Macro-Operations 

The qualification in effect when the macro-instruction 
is used will be used for symbols in the macro-expansion. 
If a qualification symbol is required within a macro- 
definition, it may be a substitutable argument, as may 
the symbols it qualifies. 

If a macro-expansion having a qualified section falls 
within the range of a qualified section in the program, 
the rules for nested qualification apply when referring 
to symbols within the macro-expansion. 
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Macro-Related Pseudo-Operations 

The iRP pseudo-operation is used to supplement the 
definition of macro-operations, whereas orgcrs and 
NOCRs are used in macro-expansions. 

The IRP Pseudo-OpemMon 

The IRP (Indefinite Repeat) pseudo-operation causes a 
sequence of instructions within a macro-operation to be 
repeated with one parameter varied at each repetition. 
The format of the irp pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


IRP 


1 . A single substitutable argu- 
ment, or 

2. Blanks 



To repeat a sequence of instructions, two irp pseudo- 
operations are required within a macro-definition — one 
to initiate the sequence and the other to end it. A single 
substitutable argument that originally appeared in the 
variable field of the preceding macro pseudo-operation 
must appear in the variable field of the initial irp 
pseudo-operation. The variable field of the second irp 
pseudo-operation is left blank. 
For example, the operation 

IRP A 

initiates a sequence, whereas 

IRP 
ends the sequence. 

Substitutable argument A governs the iteration of the 
instructions. If a symbol other than a single substitu- 
table argument or more than one subfield appears in 
the variable field of the first irp pseudo-operation, the 
pseudo-operation is ignored and a warning message is 
issued. 

In the macro-instruction, substitutable argument A 
is replaced by one or more subarguments enclosed in 
parentheses and separated by commas. Each time the 
macro-instruction is used, the assembly program gener- 
ates the sequence of instructions with each of the sub- 
arguments used successively in place of suitable 
argument A. If only one subargument is used, the 
sequence of instructions will be generated only once. 
If no subarguments are given, the whole sequence will 
be skipped. If a blank appears within the parentheses, 
only the arguments to the left of the blank will be effec- 
tive. For example, given the macro-definition 

XYZ 



MACRO 


ARG.B 


IRP 


ARC 


CLA 


ARC 


ADD 


B 


STO 


ARC 


IRP 




ENDM 


XYZ 



the macro-instruction 
XYZ 
generates 

CLA 

ADD 

STO 

CLA 

ADD 

STO 

CLA 

ADD 

STO 



(J,K,L), CONST 



J 

CONST)- (First iteration, with 

J ) subargument J) 

CONST > (Second iteration, with 
K J subargument K) 

CONST WThird iteration, with 
L ^ subargument L) 



If the substitutable argument does not appear be- 
tween the two irp pseudo-operations, the generated 
sequences will be identical, their number depending on 
the number of subarguments given. 

For example, given the macro-definition 



BBB 



the macro-instruction 



MACRO 


C,D,E 


IRP 


C 


CLA 


D 


STO 


E 


IRP 




ENDM 


BBB 



generates 



BBB 



CLA 
STO 
CLA 
STO 
CLA 
STO 



( 1,2,3 ),DATA1,DATA2 



DATAI 
DATA2 
DATAI 
DATA2 
DATAI 
DATA2 



An irp pseudo-operation may not occur explicitly 
within the range of another irp. Such a nested pair 
causes termination of the first range and opening of a 
second range. However, a macro-instruction within the 
range of an irp pseudo-operation may itself cause pairs 
of irp pseudo-operations to be generated at a lower 
level. 

Created Symbols 

If parameters are missing from the end of the variable 
field of the macro-instruction, symbols are created to 
fill the vacancies. These symbols take the form 

..0001 

..0002 



No created symbols are supplied for an explicitly null 
argument. Created symbols are supplied only at the end 
of the parameters. 

For example, if the macro pseudo-operation 

ALPHA MACRO A,B,C 

is followed by the macro-instruction 
ALPHA X„ 
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substitutable argument A is replaced by X, substitu- 
table argument: B is omitted since the parameter is ex- 
plicitly void, and substitutable argument C is replaced 
by a symbol of the form . . nnnn. This symbol is created 
to i:eplace the omitted parameter at the end of the 
variable field of the macro-instruction. 
Cliven the macro-definition 

N,B,C,D,E,A,X 

A,4 

N,4 

B,4 

/C/ = // 

D,4 

E,4 

X,4,l 

** ^ 

XFAD,CRS 
4,DATA,AD,DATA1,DATA2 



XFAD MACRO 

SXA 

AXT 
X CLA 

IFF 

F'C 

STO 

TIX 
A AXT 

ENDM 

the macro-instruction 

XFAD 
generates 

SXA ..0001,4 

AXT 4,4 

.0002 CLA DATA,4 

FAD DATA1,4 

STO DATA2,4 

TIX ..0002,4,1 

..0001 AXT **,4 

However, the macro-instruction 

XFAD 4,DATA,„DATA2 
generates 



..0002 



.0001 



SXA 
AXT 
CLA 
STO 
TIX 
AXT 



..0001,4 

4,4 

DATA,4 

DATA2,4 

..0002,4,1 

♦ * 4 



In this example, the number of instructions can vary 
between references, making a relative-address refer- 
ence difficult. However, by permitting the assembly 
program to generate the names, the references are cor- 
rect without requiring programmer-specified names. 

The NOCRS Pseudo-Operation 

The NOCRS pseudo-operation suppresses symbol crea- 
tion, which causes missing parameters at the end of the 
variable field of the macro-instruction to be treated as 
if they were explicitly null. The format of the nocrs 
pseudo-operation is: 



NAME FIELD 



Blanks! 



OPERATION 
FIELD 



NOCRS 



VARIABLE FIELD 



Ignored 



The ORGCRS Pseudo-Operation 

The ORGCRS pseudo-operation may be used to alter the 
form of created symbols. This pseudo-operation also 
causes symbol creation to be resumed if it has been 
suppressed by a nocrs. The format of the orgcrs 
pseudo-operation is : 



NAME FIELD 



Blanks 



OPERATION 
FIELD 



ORGCRS 



VARIABLE FIELD 



1. Blanks, or 

2. Up to 4 numeric digits, or 

3. One BCD character and 
up to 4 numeric digits. 



If a BCD character appears in the variable field, it re- 
places the second period of the created symbols. If dig- 
its appear, they will be the origin of the new set of 
created symbols. This origin will be one lower than the 
first symbol actually created. If fewer than four digits 
are used, they will be right-justified with leading zeros. 
If no digits are supplied or if the variable field is blank, 
the number will continue from the last created symbol. 

With a blank variable field, the orgcrs pseudo-opera- 
tion causes resumption or continuation of symbol 
creation. 

The PURGE Pseudo-Operation 

The PURGE pseudo-operation removes from core stor- 
age prototypes of macro-operations that are no longer 
needed, thus providing space for other prototypes. 
However, the purge pseudo-operation does not remove 
the name of the macro-operation from the name table. 
The format of the purge pseudo-operation is: 



NAME FIELD 



Blanks 



OPERATION 
FIELD 



PURGE 



VARIABLE FIELD 



A list of macro-operation names, 
separated by commas 



If an entry in the variable field of a purge pseudo- 
operation is not the name of a macro-operation, it is 
ignored and no message is issued. 

If a macro-operation is redefined, purging of the 
previous form is automatic ( a purge pseudo-operation 
is not needed). 

If a call is made to a purged macro-operation, the 
call will be ignored and an error message will be issued. 
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Appendixes 



Appendix A: Machine Operations 

All machine operations recognized by map are tabu- 
lated in this appendix, including supplementary infor- 
mation about their format and use. Listings are pro- 
vided of the 7090 machine operations, extended 
machine operations, special operations, 7094 machine 
operations, 7909 data channel commands, 1301 disk file 
orders, and 7340 Hypertape orders. 

The code letters used under identical column head- 
ings have the same significance in all tables. The bcd 
name of the machine operation is given in the column 
headed Mnemonic. 

Type indicates machine-instruction format character- 
istics by code letters having the following meanings : 



CODE 


MEANING 


A 


15-bit decrement field 


B 


No decrement field 


C 


8-bit decrement field 


D 


18-bit address field 


E 


13-bit address field 


K 


4-bit prefix field 


L 


Disk orders 



The codes in the address (Addr), tag, and decrement 
(Deer) columns signify: 

CODE MEANING 

R Subfield required. If missing, error message 

FIELD REQUIRED is issued. 

P Subfield permitted. Neither its presence nor 

absence results in a message. 
U(n) Subfield unexpected. If present, message FIELD 

NOT EXPECTED is issued. Assembly program 
truncates definition value of subfield to number 
of bits (n) shown in parentheses and, treating 
this value as a constant, adds it to value nor- 
mally appearing in subfield. 

N Subfield not allowed. If present and its value 

is not zero, message FIELD NOT ALLOWED 
is issued. Its value is always treated as a con- 
stant zero. 

If the size of a subfield differs from normal, field size is 
indicated in parentheses foUow^ing the subfield letter 
code. 

In the column headed Ind, the letter (P) indicates 
that indirect addressing is permitted and ( N ) indicates 
that is is not permitted. 

7090 Machine Operations 



NEMONIC 


TYPE 


ADDR 


TAG 


DECK 


IND 


ACL 


B 


R 


P 


U(4) 


P 


ADD 


B 


R 


P 


U(4) 


P 


ADM 


B 


R 


P 


U(4) 


P 


ALS 


B 


R 


P 


U(6) 


N 


ANA 


B 


R 


P 


U(4) 


P 


ANS 


B 


R 


P 


U(4) 


P 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


ARS 


B 


R 


P 


U(6 


) N 


AXC 


B 


R 


R 


U(6 


) N 


AXT 


B 


R 


R 


U(6 


) N 


BSF 


B 


R 


P 


U(6 


) N 


BSR 


B 


R 


P 


U(6 


) N 


BTT 


E 


R 


P 


U(6 


) N 


CAL 


B 


R 


P 


U(4 


) P 


CAQ 


C 


R 


P 


R(8 


N 


CAS 


B 


R 


P 


U(4 


) P 


CHS 


E 


N 


P 


U(6 


) N 


CLA 


B 


R 


P 


U(4 


) P 


CLM 


E 


N 


P 


U(6 


) N 


CLS 


B 


R 


P 


U(4 


) P 


COM 


E 


N 


P 


U(6 


) N 


CRQ 


C 


R 


P 


R(81 


N 


CVR 


C 


R 


P 


R(8^ 


N 


DCT 


E 


N 


P 


U(6 


) N 


DVH 


B 


R 


P 


U(4 


) P 


DVP 


B 


R 


P 


U(4 


) P 


ECTM 


E 


N 


P 


U(6 


) N 


EFTM 


E 


N 


P 


U(6 


) N 


ENB 


B 


R 


P 


U(4 


) P 


ENK 


E 


N 


P 


U(6 


) N 


ERA 


B 


R 


P 


U(4 


) P 


ESNT 


B 


R 


P 


U(4 


) P 


ESTM 


E 


N 


P 


U(6 


) N 


ETM 


E 


N 


P 


U(6 


) N 


ETT 


E 


R 


P 


U(6 


N 


FAD 


B 


R 


P 


U(4 


P 


FAM 


B 


R 


P 


U(4 


P 


FDH 


B 


R 


P 


U(4 


P 


FDP 


B 


R 


P 


U(4 


P 


FMP 


B 


R 


P 


U(4 


P 


FRN 


E 


N 


P 


U(6 


N 


FSB 


B 


R 


P 


U(4 


P 


FSM 


B 


R 


P 


U(4 


P 


HPR 


B 


P 


P 


U(6 


N 


HTR 


B 


R 


P 


U(4 


P 


HA 


B 


P 


P 


U(6 


N 


HL 


D 


R(18) 


N 


U(6 


N 


IIR 


D 


R(18) 


N 


U(6] 


N 


IIS 


B 


R 


P 


U(4] 


P 


lOT 


E 


N 


P 


U(6^ 


N 


lOCD 


A 


R 


N 


R 


P 


lOCP 


A 


R 


N 


R 


P 


lORP 


A 


R 


N 


R 


P 


lOCT 


A 


R 


N 


R 


P 


lORT 


A 


R 


N 


R 


P 


lOSP 


A 


R 


N 


R 


P 


lOST 


A 


R 


N 


R 


P 


LAC 


B 


R 


R 


U(6] 


N 


LAS 


B 


R 


P 


U(4) 


P 


LBT 


E 


N 


P 


U(6] 


N 


LCHx 


B 


R 


P 


U(4) 


P 


LDC 


B 


R 


R 


U(6) 


N 


LDI 


B 


R 


P 


U(4) 


P 


LDQ 


B 


R 


P 


U(4) 


P 


LET 


D 


R(18) 


N 


U(6) 


N 


LFTM 


E 


N 


P 


U(6) 


N 


LGL 


B 


R 


P 


U(6) 


N 


LGR 


B 


R 


P 


U(6) 


N 


LLS 


B 


R 


P 


U(6) 


N 


LNT 


D 


R(18) 


N 


U(6) 


N 


LRS 


B 


R 


P 


U(6) 


N 
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MNEMONIC 


TYPE 


ADDR 


TAG 


DE 


LSNM 


E 


N 


P 


U 


LTM 


E 


N 


P 


u 


LXA 


B 


R 


R 


u 


LXD 


B 


R 


R 


u 


MFR 


B 


R 


P 


u 


MPY 


B 


R 


P 


u 


MSE 


E 


R 


P 


u 


NOP 


B 


P 


P 


u 


NZT 


B 


R 


P 


u 


OAI 


B 


P 


P 


u 


OFT 


B 


R 


P 


u 


ONT 


B 


R 


P 


u 


ORA 


B 


R 


P 


u 


ORS 


B 


R 


P 


u 


OSI 


B 


R 


P 


u 


PAG 


B 


P 


R 


u 


PAI 


B 


P 


P 


u 


PAX 


B 


P 


R 


u 


PBT 


E 


N 


P 


u 


PDC 


B 


P 


R 


u 


PDX 


B 


P 


R 


u 


PIA 


B 


P 


P 


u 


PSE 


E 


R 


P 


u 


PXA 


B 


P 


R 


u 


PXD 


B 


P 


R 


u 


RCHx 


B 


R 


P 


u 


RCT 


E 


N 


P 


u 


RDCx 


E 


N 


P 


u 


RDS 


B 


R 


P 


u 


REW 


B 


R 


P 


u 


RFT 


D 


R(18) 


N 


u 


RIA 


B 


P 


P 


u 


RIL 


D 


R(18) 


N 


u 


RIR 


D 


R(18) 


N 


u 


RIS 


B 


R 


P 


u 


RND 


E 


N 


P 


u 


RNT 


D 


R(18) 


N 


u 


RQL 


B 


R 


P 


u 


RUN 


B 


R 


P 


u 


SBM 


B 


R 


P 


u 


SCHx 


B 


R 


P 


u 


SDN 


B 


R 


P 


u 


SIL 


D 


R(18) 


N 


u 


SIR 


D 


R(I8) 


N 


u 


SLQ 


B 


R 


P 


u 


SLW 


B 


R 


P 


u 


SSM 


E 


N 


P 


u 


SSP 


E 


N 


P 


u 


STA 


B 


R 


P 


u 


STD 


B 


R 


P 


u 


STI 


B 


R 


P 


u 


STL 


B 


R 


P 


u 


STO 


B 


R 


P 


u 


STP 


B 


R 


P 


u 


STQ 


B 


R 


P 


u 


STR 


A 


P 


P 


p 


STT 


B 


R 


P 


u 


STZ 


B 


R 


P 


u 


SUB 


B 


R 


P 


U( 


SXA 


B 


R 


R 


U( 


SXD 


B 


R 


R 


U( 


TCH 


A 


R 


N 


U( 


TCNx 


B 


R 


P 


U( 


TCOx 


B 


R 


P 


U( 


TEFx 


B 


R 


P 


U( 


TIF 


B 


R 


P 


U( 


TIO 


B 


R 


P 


U( 


TIX 


A 


R 


R 


R 


TLQ 


B 


R 


P 


U( 


TMI 


B 


R 


P 


U( 


TNO 


B 


R 


P 


U( 


TNX 


A 


R 


R 


R 



IND 

N 
N 
N 
N 
P 
P 
N 
N 
P 
N 
P 
P 
P 
P 
P 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
P 
N 
N 
N 
N 
N 
N 
N 
N 
P 
N 
N 
N 
N 
P 
P 
N 
N 
N 
P 
P 
N 
N 
P 
P 
P 
P 
P 
P 
P 
N 
P 
P 
P 
N 
N 
P 
P 
P 
P 
P 
P 
N 
P 
P 
P 
N 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECK 


IND 


TNZ 


B 


R 


P 


U(4) 


P 


TOV 


B 


R 


P 


U(4) 


P 


TPL 


B 


R 


P 


U(4) 


P 


TQO 


B 


R 


P 


U(4) 


P 


TQP 


B 


R 


P 


U(4) 


P 


TRA 


B 


R 


P 


U(4) 


P 


TRCx 


B 


R 


P 


U(4) 


P 


TSk 


B 


R 


R 


U(6) 


N 


TTR 


B 


R 


P 


U(4) 


P 


TXH 


A 


R 


R 


R 


N 


TXI 


A 


R 


R 


R 


N 


TXL 


A 


R 


R 


R 


N 


TZE 


B 


R 


P 


U(4) 


P 


UAM 


B 


R 


P 


U(4) 


P 


UFA 


B 


R 


P 


U(4) 


P 


UFM 


B 


R 


P 


U(4) 


P 


UFS 


B 


R 


P 


U(4) 


P 


USM 


B 


R 


P 


U(4) 


P 


VDH 


C 


R 


P 


R(6) 


P 


VDP 


C 


R 


P 


R(6) 


P 


VLM 


G 


R 


P 


R(6) 


P 


WEF 


B 


R 


P 


U(6) 


N 


WRS 


B 


R 


P 


U(6) 


N 


XCA 


B 


P 


P 


U(6) 


N 


XCL 


B 


P 


P 


U(6) 


N 


XEC 


B 


R 


P 


U(4) 


P 


ZET 


B 


R 


P 


U(4) 


P 



Extended Operations 

MAP provides a group of sense and select-type extended 
operation codes for programmer convenience. These 
codes permit the address portion of certain instructions 
to be specified symboHcally as part of the operation 
code, rather than octally in the address portion of the 
instruction. These codes also provide more meaningful 
mnemonics for some machine instructions. 

MAP also recognizes a group of prefix codes that can 
be used in such programming applications as forming 
constants or in subroutine calling sequences. 

SENSE TYPE 

The following extended operation codes of the sense 
type are recognized by the assembly program. The tag 
subfield is permitted in all these operation codes, but 
indirect addressing is not permitted in any of them. 
The letter x is to be replaced by one of the channel 
letters. 



MNEMONIC 

BTTx 

ETTx 

SLF 

SLN 

SLT 

SPRx 

SPTx 

SPUx 

SWT 

SELECT TYPE 



ADDR 

N 
N 
N 
R 
R 
R 
N 
R 
R 



DECK 

U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 



The following extended operation codes of the select 
type are recognized by the assembly program. The tag 
subfield is permitted in all these operation codes, but 
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indirect addressing is not permitted in any of them. 
If the following instructions are used in a relocatable 
deck, the address field must contain an integer or an 
immediate symbol. The letter x is to be replaced by a 
channel letter. 



MNEMONIC 


ADDR 


DECK 


BSRx 


R 


U(6) 


BSFx 


R 


U(6) 


RCDx 


N 


U(6) 


REWx 


R 


U(6) 


RPRx 


N 


U(6) 


RTBx 


R 


U(6) 


RTDx 


R 


U(6) 


RUNx 


R 


U(6) 


SDHx 


R 


U(6) 


SDLx 


R 


U(6) 


WEFx 


R 


U(6) 


WPBx 


N 


U(6) 


WPDx 


N 


U(6) 


WPUx 


N 


U(6) 


WTBx 


R 


U(6) 


WTDx 


R 


U(6) 


PREFIX CODES 







The following prefix codes are recognized by the as- 
sembly program. All have 15-bit decrement fields 
(Type A) with address, tag, and decrement permis- 
sible. Indirect addressing is permitted for all prefix 
codes. 



MNEMONIC 


MEANING 


PREFIX 


FIVE 


Five 


5 


FOR 


Four 


4 


FOUR 


Four 


4 


FVE 


Five 


5 


MON 


Minus One 


5 


MTH 


Minus Three 


7 


MTW 


Minus Two 


6 


MZE 


Minus Zero 


4 


ONE 


One 


1 


PON 


Plus One 


1 


PTH 


Plus Three 


3 


PTW 


Plus Two 


2 


PZE 


Plus Zero 





SEVEN 


Seven 


7 


SIX 


Six 


6 


SVN 


Seven 


7 


THREE 


Three 


3 


TWO 


Two 


2 


ZERO 


Zero 






Special Operations 

The following special operations recognized by map 
reduce coding effort for frequently occurring condi- 
tions. Indirect addressing is not permitted in any of 
these operations. 



MNEMONIC 

BFT 
BNT 
BRA 



IIB 

RIB 

SIB 

ZAC 

ZSA 

ZSD 



TYPE 

D 
D 
A 
A 
A 
A 
D 
D 
D 
B 
B 
B 



ADDR 

R 
R 
R 
P 
P 
P 
R 
R 
R 
U 
R 
R 



TAG 

N 
N 
N 
P 
P 
P 
N 
N 
N 
N 
N 
N 



DECR 

N 
N 
P 
P 
P 
P 
N 
N 
N 



U(6) PXD 
U(6) SXA 
U(6) SXD 



ASSEMBLES 
AS 

LFT(RFT) 

LNT(RNT) 

TXL 

PZE 

PZE 

PZE 

IIL(IIR) 

RIL(RIR) 

SIL(SIR) 



(See the section "The rbool and lbool Pseudo- 
Operations" for a description of special type D in- 
structions. ) 

7094 Machine Operations 

The following 7094 machine operations are recognized 
by MAP. In a 7090 assembly, these operations are re- 
placed by system macro-instructions (see Appendix 
B ) with the exceptions noted below. The 7090 system 
macro-instructions closely approximate the effects of 
the 7094 machine operations but may cause slight 
differences in the precision of the results obtained. 

If a subfield is to be supplied at execution time, tho 
notation ** must be used. The field may not be left 
blank. 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


INE 


DEAD 


B 


R 


P 


U(4 


) P 


DFAM 


B 


R 


P 


U(4 


) P 


DFDH 


B 


R 


P 


U(4 


) P 


DFDP 


B 


R 


P 


U(4 


) P 


DFMP 


B 


R 


P 


U(4 


) P 


DFSB 


B 


R 


P 


U(4 


P 


DFSM 


B 


R 


P 


U(4 


) P 


DLD 


B 


R 


P 


U(4 


) P 


DST 


B 


R 


P 


U(4 


) P 


*DUAM 


B 


R 


P 


U(4 


) P 


*DUFA 


B 


R 


P 


U(4 


P 


*DUFM 


B 


R 


P 


U(4 


P 


*DUFS 


B 


R 


P 


U(4 


P 


*DUSM 


B 


R 


P 


U(4 


P 


*EMTM 


E 


N 


P 


U(6 


N 


*LMTM 


E 


N 


P 


U(6 


N 


PGA 


B 


P 


R 


U(6 


N 


PCD 


B 


P 


R 


U(6^ 


N 


SCA 


B 


R 


R 


U(6) 


N 


SCD 


B 


R 


R 


U(6] 


N 



* These 7094 instructions are not replaced by macro-instructions 
when assembling in the 7090 mode; they are assembled as 
NOP instructions, and a low-severity message is issued. 



IBM 7909 Data Channel Commands 

The following 7909 data channel commands are recog- 
nized by the assembly program. An x in the operation 
code is to be replaced by a channel letter. 



MNEMONIC 

CPYD 

CPYP 

CTL 

CTLR 

CTLW 
(l)ICC 

LAR 

LCC 

LIP 

LIPT 

RICx 

RSCx 

SAR 

SMS 

SNS 

STCx 
(l)TCM 

TDC 



TYPE 
A 

A 
K 
K 
K 
K 
K 
K 
K 
A 
E 
B 
K 
K 
K 
B 
K 
K 



ADDR 

R 
R 
R 
R 
R 
P 
R 
R 
P 
R 
N 
R 
R 
R 
P 
P 
R 
R 



TAG 

N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
P 
P 
N 
N 
N 
P 
N 
N 



DECR 

R 
R 

N 

N 

N 

N 

N 

N 

N 

U(4) 

U(6) 

U(4) 

N 

N 

N 

U(4) 

R 

N 



IND 
P 
P 
P 
P 
P 

N 
P 
P 
N 
P 
N 
P 
P 
P 
N 
P 
P 
P 
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MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


TWT 


K 


R 


N 


N 


P 


WTK 


A 


R 


N 


U(4) 


P 


XMT 


A 


R 


N 


R 


P 



( 1 ) A count field in the high-order position of the decrement 
is assembled from the fourth subfield of the variable field. 
For example, 

ICG ,„4 



IBM 13011 Disk and 7320 Drum File Orders 

The following disk and drum file orders are recog- 
nized by MAP. The symbolic order should be written: 

Location DORD access and module, track, record 

and assembles as ten bcd digits in two successive loca- 
tions. 



MNEMONIC 

DEBM 

DNOP 

OREL 

DSAI 

DSBM 

DSEK 

DVCY 

DVHA 

DVSR 

DVTA 

DVTN 

DWRC 

DWRF 



ACCESS AND 
MODULE 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 



TRACK 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 



RECORD 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 



The access/module and track subfiields may be any 
symbolic expression. They are evaluated in the normal 
manner and converted to bcd. The low-order two char- 
acters of the access/module subfield and the low-order 
four characters of the track subfield are inserted into 
the instruction. The record subfield is taken as alpha- 
meric data, and the first two characters are used. A 
DNOP ( 1.2128 ) order is inserted in the last two charac- 
ter positions of the second word. 

IBM 7340 Hypertape Orders 

The following Hypertape orders are recognized by 
MAP. The symbolic order should be written: 

Location HORD Tape unit ( if required ) 

and assembles as two (or three for hsbr and hsel) bgd 
characters, left-justified in the word. Locations contain- 
ing two- character orders are filled with trailing hnop 
( ] 2128 ) codes. Three-character orders are repeated in 
the rightmost three characters. 



MNEMONIC 


TAPE UNIT 


HBSF 


N 


HBSR 


N 


HCCR 


N 


HCHC 


N 


HCLN 


N 


HEOS 


N 


HERG 


N 


HFPN 


N 


HNOP 


N 



MNEMONIC 


TAPE UNIT 


HRLF 


N 


HRLN 


N 


HRUN 


N 


HRWD 


N 


HSBR 


R 


HSEL 


R 


HSKF 


N 


HSKR 


N 


HUNL 


N 


HWTM 


N 



Any symbolic expression may be used in the tape unit 
subfield. The expression is evaluated and converted to 
BCD, and the low-order character is used as the Hyper- 
tape unit number ( 0-9 ) . 



Appendix B: 7090 Macro-Expansions of 7094 
Instructions 

When assembling in the 7090 mode, certain 7094 in- 
structions are replaced by equivalent 7090 macro- 
instructions. The expansions of these macro-instructions 
are provided in this appendix. 

The expansions are divided into groups in which only 
a few instructions vary from the given operation code. 
The generic macro-expansion of each group is given 
with the necessary substitutions. 

In this appendix, the symbols e.i, e.2, e.3, and e.4 
are generated by the expansions as names of temporary 
storage locations. However, these symbols must be de- 
fined by the programmer or they will be virtual. The 
symbol is generated and defined by the expansion even 
if the mode of the created symbol switch is nocrs. 

Relative addressing must be used carefully when 
7090 macro-expansions of 7094 instructions are used. 
The reason for this, of course, is that the single macro- 
instruction appearing in the source program will be 
replaced by a group of 7090 instructions during 
assembly. 

For example, at first glance the following sequence 
of instructions appears to be a loop that will form 
five, double-precision, floating-point products, where 

1. the first factor of each product is composed of the 
contents of location alpha + i and beta + i ( i = 0, 1,2,3,4 ) , 

2. the second factor is composed of the contents 
of locations mult and mult + 1, 

3. each product replaces its first factor in storage, 
and 

4. multiplication does not occur if the contents of 
ALPHA + i are negative. 



XXX 



AXT 


5,2 


GLA 


ALPHA + 5,2 


LDQ 


BETA + 5,2 


TMI 


XXX + 3 


DFMP 


MULT 


STO 


ALPHA + 5,2 


STQ 


BETA + 5,2 


TIX 


*-6,2,l 



52 



However, since the macro-instruction dfmp will be 
replaced by a macro-expansion consisting of 12 in- 
structions (see below), the tmi and tix instructions 
in this sequence would both cause transfers to some 
"unknown" instruction in the macro-expansion. 
Similarly, the sequence 



DFop 



\T 



SCD 
TXL 



* 1,2 

NAME,4,*^ 



would result in an error since the *1 indicates an in- 
struction in the macro-expansion of the sen instead of 
the TXL instruction as intended. 

When assembling in the 7094 or 7094 ii mode, the 
macro-operations listed in this section are automati- 
cally purged. 
Group 1. PC A and PCD 
For PCA, take w = A 
For PCD, take w = D 

The expansion is then 

PCw Y,T 



DFop 
or DFop 



DFop" 





NOP 


,T 




STQ 


E.l 




Fop* 


*-2 




STO 


E.2 




TXI 


*-l-l,T,-l 




XCA 






FAD 


E.l 




Fop* 


*-7 




FAD 


E.2 




TXI 


* + l,T,l 


** 






**,0 








AXT 


,0 




SXA 


CRS,4 




LAC 


*-2,4 




DFop 


0,4 


CRS 


AXT 


,4 


Y,T 








(SAVE 


Y,T 




CLA 


E.l 




DFop 


0,4 


CRS 


AXT 


,4 





PXw 
PwC 
PXw 
PwC 


Y,T 
,T 
,T 
,T 


Group 2. SCA and SCD 
For SCA, take w = A. 






For SCD, take w = D. 






The expansion is then 






SCw Y,T 


SXA 
AXC 

SXw 
LXA 


*-l-l,T 
*« 1' 

Y,T 

*-2,T 



Group 4. DLDandDST 

For DLD, take op = ld, opa = cla, and opb = ldq. 

For DST, take op = st, opa = sto, and opb = stq. 

There are four forms for these expansions: 



Group 3. DFAD, DFSB, DFAM, and DESM 
For DFAD, take op = ad. 
For DFSB, take op = sb. 
For DFAM, take op = am. 
For DFSM, take op = sm. 

In this and the following groups, the expansion below 
is also used: 



Dop 
Dop 



Dop 
or Dop 



Dop" 



Y,T 



(SAVE 



Y,T 



',0 



Y,T 



CRS 



opa 


Y,T 


opb 


Y + 1,T 


opa 


,T 


TXI 


*-l-l,T,-l 


opb* 


*-2 


TXI 


* + l,T,l 


opa 





SXA 


* + 3,4 


LAC 


*-2,4 


opb 


1.4 


AXT 


,4 


(SAVE 


Y,T 


IFT 


/opa/ = /STO/ 


CLA 


E.l 


opa 


0,4 


opb 


1,4 


AXT 


**,4 



NOP 


Y,T 


STO 


E.l 


CLA* 


*-2 


STA 


*+2 


STT 


* + l 


PXA 


,0 


SUB 


*-l 


SXA 


CRS,4 


PAC 


0,4 


CLA 


E.l 


'hese expansions: 


STQ 


E.l 


Fop 


Y,T 


STO 


E.2 


XCA 




FAD 


E.l 


Fop 


Y-I-1,T 


FAD 


E.2 



Group 5. DFMP 

There are four forms for this expansion: 



DFMP 



Y,T 



DFMP 



STO 


E.l 


FMP 


Y,T 


STO 


E.2 


LDQ 


Y,T 


FMP 


E.l 


STQ 


E.3 


STO 


E.4 


LDQ 


Y-I-1,T 


FMP 


E.l 


FAD 


E.2 


FAD 


E.3 


FAD 


E.4 


NOP 


♦ * -p 


STO 


E.l 


FMP* 


*-2 
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DFMP 
or DFMP 



DFMP* 



,0 



CRS 
Y,T 



CRS 



STO 


E.2 


LDQ* 


*_4 


FMP 


E.l 


STQ 


E.3 


STO 


E.4 


TXI 


* + l,T,-l 


LDQ* 


*-9 


TXI 


* + l,T,l 


FMP 


E.l 


FAD 


E.2 


FAD 


E.3 


FAD 


E.4 


AXT 


**,0 


SXA 


CRS 


LAC 


*-2,4 


DFMP 


0,4 


AXT 


**,4 


(SAVE 


Y,T 


CLA 


E.l 


DFMP 


0,4 


AXT 


** 4 



Group 6. DFDPandDFDH 
For DFDP, take w = P. 
For DFDPi, take w = H. 

There are four forms for these expansions: 



DFDw 



Y,T 



DFDw 



DFDw ** 

or DFDw **,0 



CRS 
DFDw* Y,T 

CRS 



STQ 


E.l 


FDw 


Y,T 


STO 


E.2 


STQ 


E.3 


FMP 


Y+1,T 


CHS 




FAD 


E.2 


FAD 


E.l 


FDw 


Y,T 


XCA 




FAD 


E.3 


NOP 


,T 


STQ 


E.l 


FDw* 


*-2 


STO 


E.2 


STQ 


E.3 


TXI 


* + l,T,-l 


FMP* 


*-6 


CHS 




FAD 


E.2 


FAD 


E.l 


TXI 


* + l,T,l 


FDw* 


*-ll 


XCA 




FAD 


E.3 


AXT 


**,0 


SXA 


CRS,4 


LAC 


*-2,4 


DFDw 


0,4 


AXT 


**,4 


(SAVE 


Y,T 


CLA 


E.l 


DFDw 


0,4 


AXT 


**,4 



Appendix C: Operation Code Formats 

The operation code formats to be used with the opd 
and OPVFD pseudo-operations are given in this ap- 
pendix. 

Operations 

Entries are made in the Combined Operations Table 
for all OPD and opvfd pseudo-operations, since the 
lookup process is the same as for any other symbol. To 
specify machine operations using opvfd, the general 
form of this entry is 

6/A,5/0,l/IND,2/ADD,2/TAG,2/DEC,18/V 
where each group of bits in the instruction word is 
specified by an octal number. The same general form 
is used for opd except that the 36-bit word is specified 
as a whole by a 12-digit octal number that will result 
in the same bit structure. 

In this format, V varies with adjective code A (de- 
scribed below). The fields add, tag, and dec refer to 
address, tag, and decrement, respectively. The follow- 
ing code is used: 

Field required 

1 Field permissible 

2 Field unexpected but allowed 

3 Field not permissible 

A 1 for iND indicates that indirect addressing is per- 
mitted, and a indicates that it is not permitted. 

The seven bits specifying fields ind, add, tag, and 
DEC are denoted by fr ( Fields Required ) . 

Pseudo-Operations 

The general form of the entry for pseudo-operations 
in the Combined Operations Table is 

06/A, 12/N, 18/0 
where A is the adjective code and N defines a specific 
pseudo-operation under that adjective code. 

The single exception is the macro call (adjective 
code 62). The format for this entry is 

06/62, 12/C, 3/SC, 15/L 
where c is the number of parameters, sc is symbol 
creation information, and l is the location of the in- 
ternal prototype. Adjective 62 is not allowed with opd 
and opvfd pseudo-operations. 

Adjective Codes 

The following list of octal adjective codes gives the 
type of operation to which each applies. 



::ODE (OCTAL) 


OPERATION TYPE 


40 


A 


41 


Prefix 


42 


Input/Output Command 


43 


B 


44 


C 


45 


D 
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CODE (OCTAL) OPERATION TYPE 

46 E 

47 Select 

50 Disk and Drum Channel Commands 
(4 fields) 

51 Disk and Drum Channel Commands 

52 Boolean Variable 

53 Disk File and Drum File Orders 

54 Unexpanded 7094 Instructions 

55 Hypertape Orders 
*56 Special Internal Code 
*57 Special Internal Code 

CODE (octal) PSEUDO-OPERATION TYPE 

60 Macro Definition 

61 Macro Related 
*62 Macro Call 

63 Location 

64 Storage Allocation 

65 Decimal Symbol Definition 

66 Boolean Symbol Definition 

67 Operation Defining 

70 Dup and Skipping 

71 Data Generating 

72 Nongenerative 

73 Absolute Assembly 
*74 Commentary 

75 Miscellaneous 

76 Special System 

77 List Control and Debug 

*This adjective code is not usable with OPD and OPVFD 
pseudo operations. 

TYPE A INSTRUCTIONS ( 40 ) 

The entry is 

O6/40,O5/0,O7/FR,O6/0,O12/OPCODE 
where opcode is an octal machine code written with the 
prefix in the first digit. For example, opcode for the in- 
struction Txi would be 1000. 

PREFIX operations ( 41 ) 

This entry is 

O6/41,O5/0,O7/FR,O6/0,O12/OPCODE 
where opcode is written with the prefix in the first digit. 
For example, opcode for the instruction pon would be 
1000. 

input/output commands ( 42 ) 

The entry is 

O6/42,O5/0,O7/FR,O3/N,O3/0,O12/OPCODE 
where opcode is written with the prefix in the first digit. 
For example, opcode for the instruction tch would be 
1000. If the instruction is a nontransmitting command 

N = 2. 

TYPE B instructions ( 43 ) 

The entry is 

O6/43,O5/0,O7/FR,O6/0,O12/OPCODE 
TYPE C instructions ( 44 ) 

The entry is 

O6/44,O5/0,O7/FR,O6/0,O12/OPCODE 



TYPE D instructions ( 45 ) 

The entry is 

O6/45,O5/0,O7/FR,O6/0,O12/OPCODE 

TYPE E instructions ( 46 ) 

The usual format is 

O6/46,O5/0,O7/FR,O3/S, 015/EA 
where S is the sign of the operation: 

If S = 0, OPCODE would be + 0760. 

If S = 1, OPCODE would be -0760. 
EA is the actual extended address of the instruction. 

SELECT instructions ( 47 ) 

The entry is 

O6/47,O5/0,O7/FR,O3/0,O3/E,O6/C,O6/OPCODE 
opcode is the Select type, as follows: 

= Read 

1 = Write 

2 = Set Density High 

3 = Set Density Low 

4 = Rewind 

5 = Rewind Unload 

6 = Backspace Record 

7 = Backspace File 
10 = WriteEndof File 

C is the channel number of Select, starting at 1 for 
Channel A. 

E is the equipment code and has the following signi- 
ficance: 

= Decimal Tape 

1 = Binary Tape; or either Binary or Decimal Tape 

2 = Card Reader 

3 = Punch 

4 = Decimal Printer 

5 = Binary Printer 

See "Select Type" operations for specific address 
field requirements. 

DISK AND DRUM CHANNEL COMMANDS ( 50 ) 

The entry is 

O6/50,O5/0,O7/FR,O6/0,O12/OPCODE 

DISK AND DRUM CHANNEL COMMANDS ( 51 ) 

The entry is 

O6/51,O5/0,O7/FR,O3/N,O3/0,O12/OPCODE 
where N = 2 if a 1 in bit position 19 is part of the 
operation code. 

BOOLEAN VARIABLE ( 53 ) 

The entry is 

O6/52,O5/0,O7/FR,O6/0,O12/OPCODE 
where the high-order bit of opcode is always on. 

DISK FILE AND DRUM FILE ORDERS ( 53 ) 

The format is 

O6/53,O6/0,O2/ACC,O2/TRK,O2/REC, 
O6/0,O12/ORCODE 
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ORCODE is the order, written in external bcd notation. 
For example, drel with an order code of 04 would be 
written 1204,, 

The Jields acc, trk, and rec refer to the access 
module, track, and record, respectively. Encoding is: 

1 Field permissible 
UNEXPANDED 7094 INSTRUCTIONS ( 54 ) 

The entry is 

O6/54,O5/0,O7/FR,O6/0,O12/OPCODE 

HYPERTAPE ORDERS ( 55 ) 

The entry is 

O6/55,O6/0,O2/ADD,O10/0,O12/OPCODE 

The following is a list of pseudo-operations cor- 
responding to specific A's and N's. 



A 


N 


PSEUDO-OPERATIO 


60 





MACRO 


61 





IFT 




1 


IFF 




2 


IRP 




3 


SET 




4 


ORGCRS 




5 


NOCRS 




6 


ENDM 


63 





USE 




1 


BEGIN 




2 


ORG 




3 


LOG 


64 





ESS 




1 


BES 




2 


COMMON 




3 


EVEN 




4 


LORG 




5 


LDIR 




6 


LITORG 


65 





EQU (andSYN) 




1 


MAX 




2 


MIN 


66 





BOOL 




1 


LBOOL 




2 


RBOOL 


67 





OPD 




1 


OPVFD 




2 


OPSYN 


70 





DUP 




1 


GOTO 


71 





OCT 




1 


DEC 




2 


BCI 




3 


LIT 




4 


VFD 


72 





QUAL 




1 


ENDQ 




2 


CONTRL 




3 


FILE 




4 


ENTRY 




5 


LABEL 


73 





ABS 




1 


FUL 




2 


TCD 




3 


PUNCH 




4 


UNPNCH 



A 


N 


PSEUDO-O: 


75 





ETC 




1 


REM 




2 


NULL 




3 


END 




4 


PURGE 


76 





CALL 




1 


SAVE 




2 


SAVEN 


77 





UNLIST 




1 


LIST 




2 


TITLE 




3 


DETAIL 




4 


EJECT 




5 


SPACE 




6 


LBL 




7 


PCC 




8 


INDEX 




9 


PMC 




10 


TTL 




11 


PCG 




12 


KEEP 



Appendix D: IBMAP-FAP Incompatibilities 

This appendix lists the incompatibilities that will occur 
when assembling a fap or ibsfap program using ibmap. 

1. All FAP machine operations and extended ma- 
chine operations will assemble properly in map. 

2. All fap pseudo-operations pertaining to the up- 
date facility have no counterpart in map. They are: 



DELETE 


NUMBER 


UMC 


ENDFIL 


REWIND 


UNLOAD 


ENDUP 


SKIPTO 


UPDATE 


IGNORE 


SKPFIL 





3. The following fap pseudo-operations have no 
counterpart in map. (Since map treats undefined op- 
erations as remarks, some of these operations do not 
affect assembly.) 

IFEOF TAPENO 

PRINT 704 

SST 9LP 

4. The following fap pseudo-operations must be 
replaced by the indicated map equivalent: 



FAP 


MAP 


HEAD.HED 


QUAL,ENDQ 


BCD 


BCI 


MOP 


MACRO 


MAC 


Standard macro-instruction 


END (of macro) 


ENDM 


RMT 


USE and USE PREVIOUS 



( Note that qual permits nesting of qualifiers, whereas 
HEAD does not.) 

The following is an example of a program segment 
coded first in fap and then in map. 



ALPHA 



RMT 

BSS 

RMT 



RMT 
EXTERN 



10 
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MAP 



SKP 




SPC 




TSX 


$SUB,4 


USE 


RMT 


BSS 


10 


USE 


PREVIOUS 


BEGIN 


RMT, ALPHA 


Leave 




symbols 




undefined 




EJECT 




SPACE 




TSX 


SUB,4 (remov( 



specify external names) 

5. The; following pseudo-operations have identical 
names in fap and map but differ in context or meaning: 
IFF 

The meaning of the mnemonic and, therefore, the con- 
tents of the variable field, differ. 

COMMON 

COMMON counter increments forward in MAP. 

DUP 

In MAP, the S-value of symbolic instruction and iteration 
counts is vised. Therefore, a FAP sequence such as 

N EQU 5 

DUP 1,N 

must be changed in MAP to 

N SET 5 

DUP 1,N 

Also, in MAP, a symbol placed in the name field of a 
card within the range of a DUP is duplicated along with 
the rest of the card. 

EQU.SYN 

In MAP, these apply to symbol definitions only and 
carmot be used where an S-value is required; see DUP 
above. 

OPD,OPVFD 

The variable field should correspond to the MAP diction- 
ary entry format (see Appendix C). 

MACRO 

In MAP, this is used as 
NAME MACRO A,B,C,... 

and may not be used as 
MACRO 
NAME A,B,C,... 



NULL 



CALL 



SET 



LOC 

In MAP, the expression 

LOC blank 

is meaningless. The effect of a LOC is terminated with 
the ORG pseudo-operation. 

In MAP, a symbol in the name field of the card will be 
given the value of the current location counter. 

In MAP, the arguments must be enclosed in parentheses. 
Also, a different calling sequence is generated. 

In MAP, the S-value of symbols in the variable field is 
used. 

6. The following fap pseudo-operations have their 

equivalent option specified on the $ibmap card: 

REF 
7090 
COUNT 
SST 

7. In MAP, the null pseudo-operation rather than 
EQU * should be used for symbol definition, because of 
the limited size of the Pseudo-Operation Dictionary. 

8. The following fap pseudo-operations will as- 
semble properly in map: 



ABS 

BCI 

BES 

BOOL 

BSS 

DEC 

DETAIL 

EJECT 

ENTRY 

ETC 



FULL 

INDEX 

LBL 

LIST 

MAX 

MIN 

NOCRS 

OCT 

OPSYN 

ORG 



ORGCRS 

PCC 

PMC 

REM 

SPACE 

TCD 

TITLE 

UNLIST 

TTL 

VFD 



9. In MAP, virtual entries in the Control Dictionary 
correspond to the transfer vector of fap except that 
iBLDR provides direct rather than indirect references. 

10. In map, normal arithmetic truncates to 15 bits 
in the address field, 3 in the tag, and as specified in 
the decrement, vfd symbolic arithmetic truncates to 
a maximum of 20 bits. Boolean arithmetic truncates to 
18 bits. 

11. Literals are placed in the literal pool in the; 
order in which they appear in a program; they are not 
arranged numerically. 
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Appendix E: The MAP BCD Character Code 

The MAP BCD character code is shown in octal form in 
in the following table with the corresponding ibm 
punched card code. 



CHARACTER 

(blank) 


1 

2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C] 
D 
E 
F 

c; 
n 
I 



BCD .CODE (octal) 


CARD CODE 


60 


(blank) 


00 





01 


1 


02 


2 


03 


3 


04 


4 


05 


5 


06 


6 


07 


7 


10 


8 


11 


9 


21 


12-1 


22 


12-2 


23 


12-3 


24 


12-4 


25 


12-5 


26 


12-6 


27 


12-7 


30 


12-8 


31 


12-9 





J 


41 




K 


42 




L 


43 




M 


44 




N 


45 




O 


46 




P 


47 




Q 


50 




R 


51 




S 


62 




T 


63 




U 


64 




V 


65 




w 


66 




X 


67 




Y 


70 




Z 


71 


+ 


(plus) 


20 


- 


( minus ) 


40 


/ 


( slash ) 


61 


= 


( equals ) 


13 


' 


( apostrophe ) 


14 




( period ) 


33 


) 


( right parenthesis) 


34 


$ 


( dollar sign ) 


53 


* 


(asterisk) 


54 


J 


( comma ) 


73 


( 


( left parenthesis ) 


74 



11-1 

11-2 

11-3 

11-4 

11-5 

11-6 

11-7 

11-8 

11-9 

0-2 

0-3 

0-4 

0-5 

0-6 

0-7 

0-8 

0-9 

12 

11 

0-1 

8-3 

8-4 

12-8-3 

12-8-4 

11-8-3 

11-8-4 

0-8-3 

0-8-4 
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Index 



ABs pseudo-operation 34 

Absolute assemblies 6, 34 

Absolute-assembly pseudo-operations 6, 34 

Absolute expression 11 

Absolute origin 6, 9, 15 

Absolute symbols 9 

Adjective codes 54 

Alphameric literal 10 

Alphameric subfield in vfd 20 

Assembly-program language 5 

Asterisk ( * ) 

as an element H 

in indirect addressing 7 

in relative addressing 12 

remarks card g 

BCD character code 57 

Bci pseudo-operation - , . 19 

BEGIN pseudo-operation 14 

BEs pseudo-operation 16 

Binary-place part in fixed-point number 10 

Binary transfer card 34 

Bit count of VFD 20 

Blank common 14 17 27 

Blank location counter I4 

BOOL pseudo-operation 24 

Boolean expressions 12 24 

Boolean pseudo-operations 5 24 

Boolean variable code format '55 

Bss pseudo-operation I5 

CALL pseudo-operation 37 

Calling macro-operations 43 

Calling sequence 37 

Comments field 7 

COMMON pseudo-operation 17 

Coinpiler program 5 

Complex expression H 

Conditional-assembly in macro-operations 45 

Conditional-assembly pseudo-operations 5, 24 

Constants 9 18 

coNTRL pseudo-operation 27 

Control section . 26 

Control-section pseudo-operations 5, 26 

Created symbols in macro-operations 47 

"Current" location counter 6 

Data-generating pseudo-operations 5, 18 

Data item, decimal 9 

Debugging dictionary 16, 17, 22, 34 

DEC pseudo-operation 19 

Decimal data item 9 

Decimal integer 9 

Decimal literals g 

Defining macro-operations 41 

Defining symbols 8 

DETAIL pseudo-operation 35 

Dimension 16, 22, 34 

Disk and Drum channel command format 55 

Disk file and drum file order format 55 

Disk file and drum file orders 52 

Double-precision literals 10 17 20 

Dup pseudo-operation '. . . ' 21 

EJECT pseudo-operation 35 

Elements in expressions 11 

END pseudo-operation 33 

ENDM pseudo-operation 41, 43 



ENDQ pseudo-operation 26 

ENTRY pseudo-operation 27 

EQU pseudo-operation 22 

Error checking q 

Error returns 35 

ETC pseudo-operation 33 

Evaluating expressions n 

EVEN pseudo-operation 17 

Expansions 

of CALL 3g 

in macro-operations 41 43 

of SAVE 38 

Exponent part 

fixed-point number 10 

floating-point number 10 

Expression** jj 

Expressions n 

absolute n 

Boolean 12 

complex II 

elements of n 

evaluation of n 

operators in n 

relocatable n 

rules for forming n 

symbols in ^2 

terms in u 

writing of n 

Extended machine operations 50 

External file name 28 

FAP-iBMAP incompatibilities ... 55 
Fields 

comments y 

instruction g 

name n 

operation j 

sequence 

variable y 

File-description pseudo-operations 5, 28 

File identification name 32 

File name 30 

external £8 

File options 

activity £9 

block sequence 30 

block size 29 

block-size check 31 

checkpoint ;^q 

checkpoint location 30 

check sum 3Q 

conversion 31 

disk/drum cylinder count 31 

disk/drum starting cylinder number 30 

disk/drum v^'rite-checking 3^ 

file close 3Q 

file density on 

file mounting 29 

file usage £9 

Hypertape 3^ 

Hypertape reel switching 31 

label density 30 

mode 30 

nonstandard-label routine 31 

operator file list 29 
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pool-attachment 31 

reel handling 30 

B'lLE pseudo-operation 28 

File serial number 32 

File unit 

primary 28 

secondary 28 

File tmit-assignment option 28 

Fixed-point number 10 

Floating-point number 9 

Format 

Boolean variable code 55 

disk and drum channel commands 55 

disk and drum file orders 55 

Ilypertape orders 56 

Input/Output Commands 55 

operation code 54 

prefix operation code 55 

select instruction code 55 

type A. instruction code 55 

type B instruction code 55 

type G instruction code 55 

type E instruction code 55 

unexpanded 7094 instruction code 56 

FUL, pseudo-operation 34 

GOTO pseudo-operation 25 

Hypertape order format 56 

Hypertape orders 52 

iBMAP-FAP Inc:ompatibilities 56 

IFF pseudo-operation 24, 45 

iFT pseudo-operation 24, 45 

Immediate symbols 9, 23 

INDEX pseudo-operation 36 

Indirect addressing 7 

Input/output command format 55 

Instruction count of dup 21 

Instruction fields 6 

Instructions, tj'pe D 9, 23, 54 

Integer 

decimal 9 

octal 10 

iiip pseudo-operation 47 

Irrelevant subfield 7 

Iteration count of dup 21 

KEEP pseudo-operation 16, 22, 34 

LABEL pseudo-operation 31 

Languages 

assembly program 5 

c;ompiler 5 

machine 5 

MAP 5 

LBL psevido-operation 36 

LBOOL pseudo-operation 24 

LDiR pseudo-operation 17 

Linkage Director 17, 38 

List-control pseudo-operations 6, 35 

LIST pseudo-operation 35 

LIT pseudo-operation 20 

Literal Fool 9, 10, 17, 18, 20 

Literals 9 

alphameric 10 

decimal 9 

double-precision 10, 17 

octal 10 

LiTORG pseudo-operation 18 

liOad address 6 

LOG pseudo-operation 15 

liOcation-counter pseudo-operations 5, 14 

liOcation counter // 14, 17, 27 

Ijocation counters 6, 14 

"current" 6 



Location symbols 8 

LORG pseudo-operation 18 

Machine-language program 5 

Machine operations 49 

extended 50 

select-type extended • 50 

sense-type extended 50 

7090 49 

7094 • ■ 51 

Macro-defining pseudo-operations 6, 41 

Macro-definition heading card 41 

Macro-definitions 41 

Macro-expansions 41, 43 

inserting instructions in 45 

of 7094 instructions 52 

Macro-instructions 41, 43 

delimiting parameters in 43 

in macro-definitions 44 

parameters in • • 44 

Macro-operation facility 6, 41 

M acro-oper ations 

conditional assembly in 45 

nested 46 

qualification in ■ 46 

MACRO pseudo-operation • 41 

Macro-related pseudo-operations 6, 47 

MAP BCD character code 57 

MAP language features 5 

MAP pseudo-operations ■ 14 

MAX pseudo-operation • • 23 

MiN pseudo-operation 23 

Miscellaneous pseudo-operations 6, 33 

Modal and dimensional information 16, 22, 34 

Mode 16, 22, 34 

Name field 7 

Names 

external file 28 

file 32 

Nested dup pseudo-operations 21 

Nested macro-operations 46 

Nested qualification 26 

NOCRS pseudo -operation 48 

NOPOOL option • • 31 

NULL pseudo-operation 22 

Null subfield 7 

Numbers 

fixed point 10 

floating point ■ • 9 

Object program 5 

OCT pseudo-operation 18 

Octal integers ■ 10 

Octal literals 10 

Octal subfield in vfd ■ • 20 

OPD pseudo-operation 32, 54 

Operation code formats 54 

Operation-defining pseudo-operations 5, 32 

Operation field 7 

Operators 

in Boolean expressions 12 

in expressions 11 

relational ■ • 24 

OPSYN pseudo-operation 32 

Options 

disk and drum cylinder count 31 

disk and drum starting-cylinder number 30 

disk and drum w^rite-checking 31 

file activity 29 

file block sequence 30 

file block size 29 

file block-size check 31 

file checkpoint 30 

file checkpoint location 30 
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file check-sum 30 

file close 30 

file conversion 31 

file density 30 

file label density 30 

file mode 30 

file mounting 29 

file nonstandard-label routine 31 

file reel handling 30 

file unit assignment 28 

file usage 29 

Hypertape 31 

Hypertape reel switching 31 

operator file list 29 

OPFVD pseudo-operation 32, 54 

Orders 

disk and drum file 52 

Hypertape 52 

Ordinary symbols 8 

ORG pseudo-operation 15 

ORGCRS pseudo-operation 48 

Origin 

absolute 9 15 

relocatable g 

Parameters 

dehmiting in macro-instructions 44 

in macro-instructions 44 

pcc pseudo-operation 35 

PCG pseudo-operation 37 

PMC pseudo-operation 3q 

Prefix codes gj 

Prefix operation code format 54 

Primary file unit 28 

Principal part 

fixed-point number, 10 

floating-point number g 

Prototype card images 42 

Prototype instructions 42 43 

substitutable arguments in '45 

text in 45 

Pseudo-operation 5 

Pseudo-operation code formats 54, 55 

Pseudo-operations 

ABS 34 

absolute-assembly 6 34 

Bci ' ig 

BEGIN 14 

BES 26 

BOOL 24 

Boolean 5 24 

Bss ......' 15 

CALL 37 

COMMON 27 

conditional-assembly 5 24 

CONTRL 27 

control-section 5, 26 

data-generating 5, 18 

DEC ' ig 

DETAIL 35 

DUP 21 

EJECT 35 

END 33 

ENDM 41^43 

ENDQ 26 

ENTRY 27 

EQU 22 

ETC 33 

EVEN 17 

FILE 28 

file-description 5, 28 

FUL '34 

GOTO 25 



iFE 24, 45 

iFT 24, 45 

INDEX 3Q 

IRP 47 

KEEP 16, 22, 34 

LABEL 31 

LBL 36 

LBOOL 24 

LDIR 27 

LIST 35 

list-control 6 35 

LIT ......'20 

LITORG 28 

LOG 15 

location-counter 5, 14 

LORG 28 

MACRO 42 

macro-defining 6, 41 

macro-related 6, 46 

MAX '23 

MIN 23 

miscellaneous 6 32 

NOCRS 48 

NULL 22 

OCT 28 

OPD !'!',32,54 

operation-defining 5, 32 

OPSYN '32 

OPVFD 32, 54 

ORG 15 

ORGCRS 48 

PCG '.'.'.'.'.'.'..'.'. 35 

PCG 37 

PMG 36 

PUNCH 34 

QUAL ^ ! ! . . 25 

RBOOL ; 24 

REM . . ., 33 

RETURN 3g 

SAVE ...'.'.'.'..'.. 38 

SAVEN 3g 

SET 9, 22, 23 

SPACE 35 

special systems 6 37 

storage-allocation 5* 15 

symbol-defining 5 22 

symbol-qualifying 5 25 

SYN '22 

TGD ■ ■ 34 

TITLE 35 

TTL 37 

UNLIST 35 

UNPNCH 34 

USE 24 

VF» '.'.'.'.'.'.'. 19 

PUNCH pseudo-operation 34 

PURGE pseudo-operation 48, 53 

QUAL pseudo-operation 25 

Qualification 

in macro-operations 46 

nested £6 

Qualified section £6 

Qualified symbol £6 

RBOOL pseudo-operation £4 

Relational operator £4 

Relative addressing 12 

Relocatable assemblies 6 

Relocatable expressions 11 

Relocatable origin 9 

Relocatable segments 26 

Relocation properties of symbols 9 

REM pseudo-operation 33 
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Remarks card " 

Retention, period for files 32 

RETURN pseudo-operation 39 

Returns, error 39 

S-value 9 

SAVE pseudo-operation 38 

SAVEN pseudo-operation 39 

Secondary file unit 28 

Stictions 

control 26 

qualified 25 

Scsgmcnts, relocatable 26 
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